Java 和 领域 最 有 影响 力 和 价值 的 著作 之 一 ， 与 《Java 编 程 思想 》 齐 名 ，10 余 年 
全 球 畅销 不 衰 ， 广 受 好 评 

sgr ”根据 java SE 8 全 面 更 新 ， 系 统 全 面 讲 解 Java 语 言 的 核心 概念 、 语 法 、 重 要 特 
性 和 开发 方法 ， 包含 大 量 案例 ， 实 践 性 强 
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内 容 简 介 


java 领域 最 有 影响 力 和 价值 的 著作 之 一 ， 
由 拥有 20 多 年 教学 与 研究 经 验 的 资深 Java 技 
术 专 家 撰写 ( 获 Jolt 大 奖 ) ， 与 《Java 编 程 丰 
想 》 齐 名 ，10 余 年 全 球 畅销 不 误 ， 广 受 好 评 。 
第 10 版 根据 Java SE 8 全 面 更 新 ， 同 时 修正 了 第 
9 版 中 的 不 足 ， 系 统 全 面 讲解 了 Java 语 言 的 核 
心 概念 、 语 法 、 重 要 特性 和 开发 方法 ， 包 含 大 
量 案例 ， 实 践 性 强 . 

本 书 共 12 章 。 第 1 章 概 述 Java 8 的 流 库 ， 
第 2 章 的 主题 是 输入 输出 处 理 ; 第 3 章 介绍 
XML , 怎样 解析 XML 文件 ， 怎 样 生成 XML 以 
及 怎样 使 用 XSL 转 换 ; 第 4 章 讲解 网 络 AFI | 
第 5 章 介绍 数据 库 编程 ， 重 点 讲解 JDBC ; 第 
6 章 讲 解 如 何 使 用 新 的 日 期 和 时 间 库 来 处 理 日 
历 和 时 区 的 复杂 性 ; 第 7 章 讨 论 国际 化 ; 第 8 
章 介 绍 3 种 处 理 代 码 的 技术 ; 第 9 章 讲 解 安 全 
模型 ; 第 10 章 涵盖 没有 纳入 卷 I 的 所 有 ?wing 
知识 ; 第 11 章 介绍 Java 2D API; 第 12 章 讲 
解 本 地 方法 。 
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译 者 & 


《 Java 核心 技术 卷 了 ”高 级 特性 ( 原 书 第 10 版 )》 中 文 版 又 要 呈现 在 广大 读者 的 面前 
了 ! 这 是 我 翻译 的 本 书 的 第 4 个 版 本 ， 细 心 一 看 ， 才 发 现 距离 最 早 的 第 7 版 已 经 过 去 了 将 近 
12 年 ， 岁 月 神偷 悄然 改变 着 我 的 音 容 相 貌 ， 也 让 Java 语言 不 断 地 完善 演化 ， 发 生 了 脱胎 换 
骨 般 的 变化 。 

随 着 Java 语言 的 更 新 ， 本 书 的 内 容 也 进行 了 大 幅度 的 调整 ， 新 增 了 Java SE 8 中 的 流 库 ， 
以 及 日 期 和 时 间 API 的 内 容 ， 调 整 掉 了 JavaBean 和 RMI 等 内 容 ， 使 得 本 书 的 内 容 既 反映 了 
Java 语言 的 新 变化 ， 又 显得 更 加 紧凑 ， 达 到 了 与 时 俱 进 的 目的 。 

本 书 实际 上 并 不 适合 Java 初学 者 ， 它 更 适合 有 一 定 Java 编程 基础 的 程序 员 ， 因 为 具备 
一 定 的 基础 知识 才能 更 好 地 理解 本 书 的 内 容 ， 这 也 是 卷 开 被 称 为 “高 级 特性 ”的 原因 。 通 过 
阅读 本 书 ， 你 会 了 解 到 高 级 特性 的 细节 ， 它 们 涉及 复杂 系统 的 各 个 方面 ， 是 开发 更 好 、 更 
快 、 更 安全 和 更 易 维护 的 系统 所 必 不 可 少 的 语言 特性 。 

在 这 一 版 的 翻译 工作 中 ， 我 对 原文 没有 变化 的 部 分 也 进行 了 仔细 修订 ， 尽量 修改 了 其 中 
的 错误 和 翻译 不 通顺 的 语句 。 令 人 汗颜 的 是 ， 虽然 已 经 修订 过 3 版 了 ， 在 这 一 版 中 还 是 发 现 
了 不 少 错误 ， 在 此 我 向 所 有 之 前 版 本 的 读者 道歉 ， 也 晨 请 读者 对 这 一 版 中 的 廖 误 提出 批评 。 

最 后 ， 祝 大 家 通过 阅读 本 书 不 但 能 够 提升 Java 编程 能 力 ， 更 能 够 加 深 对 Java 编程 语言 
的 理解 和 认识 。 让 我 们 共同 学 习 ， 永 远 在 路 上 ! 


Me K MÉ, 





Di 


Al 


致 读者 


本 书 是 按照 Java SE 8 完全 更 新 后 的 《 Java 核心 技术 卷 高 级 特性 ( 原 书 第 10 版 )》。 
卷 工 主要 介绍 了 Java 语言 的 一 些 关键 特性 ; 而 本 卷 主要 介绍 编程 人 员 进行 专业 软件 开发 时 需 
要 了 解 的 高 级 主题 。 因 此 ， 与 本 书卷 和 之 前 的 版 本 一 样 ， 我 们 仍 将 本 书 定位 于 用 Java 技术 
进行 实际 项 目 开 发 的 编程 人 员 。 

编写 任何 一 本 书籍 都 难免 会 有 一 些 错误 或 不 准确 的 地 方 。 我 们 非常 乐意 听 到 读者 的 意 
见 。 当 然 ， 我 们 更 希望 对 本 书 问题 的 报告 只 听 到 一 次 。 为 此 ， 我 们 创建 了 一 个 FAQ 、bug 修 
正 以 及 应 急 方 案 的 网 站 http:// horstmann.com/corejava。 你 可 以 在 bug 报告 网 页 〈 该 网 页 的 目 
的 是 鼓励 读者 阅读 以 前 的 报告 ) 的 末尾 处 添加 bug 报告 ， 以 此 来 发 布 bug 和 问题 并 给 出 建议 ， 
以 便 我 们 改进 本 书 将 来 版 本 的 质量 。 


内 容 提 要 


本 书 中 的 章节 大 部 分 是 相互 独立 的 。 你 可 以 研究 自己 最 感 兴趣 的 主题 ， 并 可 以 按照 任意 
顺序 阅读 这 些 章 市 。 

在 第 1 章 中 ， 你 将 学 习 Java 8 的 流 库 ， 它 带 来 了 现代 风格 的 数据 处 理 机 制 ， 即 只 需 指 
定 想 要 的 结果 ， 而 无 须 详 细 描述 应 该 如 何 获 得 该 结果 。 这 使 得 流 库 可 以 专注 于 优化 的 计算 策 
略 ， 对 于 优化 并 发 计算 来 说 ， 这 显得 特别 有 利 。 

第 2 章 的 主题 是 输入 输出 处 理 。 在 Java 中 ， 所 有 LO 都 是 通过 输入 /输出 流 来 处 理 的 。 
这 些 流 (不 要 与 第 1 章 的 那些 流 混淆 了 ) 使 你 可 以 按照 统一 的 方式 来 处 理 与 各 种 数据 源 之 间 
的 通信 ， 例 如 文件 、 网 络 连接 或 内 存 块 。 我 们 对 各 种 读 人 器 和 写 出 器 类 进行 了 详细 的 讨论 ， 
它们 使 得 对 Unicode 的 处 理 变 得 很 容易 。 我 们 还 展示 了 如 何 使 用 对 象 序列 化 机 制 从 而 使 保存 
和 加 载 对 象 变 得 容易 而 方便 ， 及 其 背后 的 原理 。 然 后 ， 我 们 讨论 了 正则 表达 式 和 操作 文件 与 
路 径 。 

第 3 章 介 绍 XML， 介 绍 怎 样 解析 XML 文件， 怎样 生成 XML 以 及 怎样 使 用 XSL 转换 。 
在 一 个 实用 示例 中 ， 我 们 将 展示 怎样 在 XML 中 指定 Swing 窗 体 的 布局 。 我 们 还 讨论 了 XPath 
API， 它 使 得 “在 XML 的 干草 堆 中 寻找 绣花 针 ” 变 得 更 加 容易 。 

第 4 章 介绍 网 络 API。Java 使 复杂 的 网 络 编程 工作 变 得 很 容易 实现 。 我 们 将 介绍 怎样 创 
建 连接 到 服务 器 上 ， 怎 样 实现 你 自己 的 服务 器 ， 以 及 怎样 创建 HTTP 连接 。 

第 5 章 介 绍 数 据 库 编程 ， 重 点 讲解 DBC， 即 Java 数据 库 连 接 API， 这 是 用 于 将 Java 程 


序 与 关系 数据 库 进 行 连接 的 API。 我 们 将 介绍 怎样 通过 使 用 JDBC API 的 核心 子 集 ， 编 写 能 
够 处 理 实际 的 数据 库 日 常 操作 事务 的 实用 程序 。( 如 果 要 完整 介绍 JDBC API 的 功能 ， 可 能 
需要 编写 一 本 像 本 书 一 样 厚 的 书 才 行 。) 最 后 我 们 简要 介绍 了 层次 数据 库 ， 探 讨 了 一 下 INDI 
(Java 命名 及 目录 接口 ) UR LDAP ( 轻 量 级 目录 访问 协议 )。 

Java 对 于 处 理 日 期 和 时 间 的 类 库 做 出 过 两 次 设计 ， 而 在 Java 8 中 做 出 的 第 三 次 设计 则 极 
富 魅 力 。 在 第 6 章 ， 你 将 学 习 如 何 使 用 新 的 日 期 和 时 间 库 来 处 理 日 历 和 时 区 的 复杂 性 。 

第 7 章 讨论 了 一 个 我 们 认为 其 重要 性 将 会 不 断 提升 的 特性 一 一 国际 化 。Java 编程 语言 是 
少数 几 种 一 开始 就 被 设计 为 可 以 处 理 Unicode 的 语言 之 一 ， 不 过 Java 平台 的 国际 化 支持 则 走 
得 更 加 深远 。 因 此 ， 你 可 以 对 Java 应 用 程序 进行 国际 化 ， 使 得 它们 不 仅 可 以 路 平台 ， 而 且 还 
可 以 跨越 国界 。 例 如 ， 我 们 会 展示 怎样 编写 一 个 使 用 英语 、 德 语 和 汉语 的 退休 金 计 算 占 。 

第 8 章 讨 论 了 三 种 处 理 代码 的 技术 。 脚 本 机 制 和 编译 器 API 允许 程序 去 调用 使 用 诸如 
JavaScript 或 Groovy 之 类 的 脚本 语言 编写 的 代码 ， 并 且 人 允许 程序 去 编译 Java 代码 。 可 以 使 用 
注解 向 Java 程序 中 添加 任意 信息 (有 时 称 为 元 数据 )。 我 们 将 展示 注解 处 理 器 怎样 在 源码 级 
别 或 者 在 类 文件 级 别 上 收集 这 些 注 解 ， 以 及 怎样 运用 这 些 注解 来 影响 运行 时 的 类 行为 。 注 解 
只 有 在 工具 的 支持 下 才 有 用 ， 因 此 ， 我 们 希望 我 们 的 讨论 能 够 帮助 你 根据 需要 选择 有 用 的 注 
解 处 理工 具 。 

第 9 章 继续 介绍 Java 安全 模型 。Java 平 台 一 开始 就 是 基于 安全 而 设计 的 ， 该 章 会 市 你 深 
入 内 部 ， 查 看 这 种 设计 是 怎样 实现 的 。 我 们 将 展示 怎样 编写 用 于 特殊 应 用 的 类 加 载 磺 以 及 安 
全 管理 器 。 然 后 介绍 允许 使 用 消息 、 代 码 签名 、 授 权 以 及 认证 和 加 密 等 重要 特性 的 安全 API 
最 后 ， 我 们 用 一 个 使 用 AES 和 RSA 加 密 算法 的 示例 进行 了 总 结 。 

第 10 章 涵盖 了 没有 纳入 卷 I 的 所 有 Swing 知识 ， 尤 其 是 重要 但 很 复杂 的 树 形 构件 和 表 
格 构件 。 随 后 我 们 介绍 了 编辑 面板 的 基本 用 法 、“ 多 文档 ”界面 的 Java 实现 、 在 多 线程 程序 
中 用 到 的 进度 指示 器 ， 以 及 诸如 闪 屏 和 支持 系统 托盘 这 样 的 “桌面 集成 特性 ”。 我 们 仍 看 重 
介绍 在 实际 编程 中 可 能 遇 到 的 最 为 有 用 的 构件 ， 因 为 对 Swing 类 库 进行 百科 全 书 般 的 介绍 可 
能 会 占据 好 几 卷 书 的 篇 幅 ， 并 且 只 有 专门 的 分 类 学 家 才 感 兴趣 。 

第 11 章 介绍 Java 2D API， 你 可 以 用 它 来 创建 实际 的 图 形 和 特殊 的 效果 。 该 章 还 介绍 了 
抽象 窗口 操作 工具 包 (AWT) 的 一 些 高 级 特性 ， 这 部 分 内 容 看 起 来 过 于 专业 ， 不 适合 在 卷 
中 介绍 。 虽 然 如 此 ， 这 些 技术 还 是 应 该 成 为 每 一 个 编程 人 员工 具 包 的 一 部 分 。 这 些 特性 包括 
打印 和 用 于 剪 切 粘贴 及 拖 放 的 API。 

第 12 章 介绍 本 地 方法 ， 这 个 功能 可 以 让 你 调用 为 微软 Windows API 这 样 的 特殊 机 制 而 
编写 的 各 种 方法 。 很 显然 ， 这 种 特性 具有 争议 性 : 使 用 本 地 方法 ,那么 Java 平台 的 路 平台 特 
性 将 会 随 之 消失 。 虽 然 如 此 ， 每 个 为 特定 平台 编写 Java 应 用 程序 的 专业 开发 人 员 都 需要 了 解 
这 些 技术 。 有 时 ， 当 你 与 不 支持 Java 平台 的 设备 或 服务 进行 交互 时 ， 为 了 你 的 目标 平台 ， 你 
可 能 需要 求助 于 操作 系统 API。 我 们 将 通过 展示 如 何 从 某 个 Java 程序 访问 Windows 注册 表 
API 来 阐明 这 一 点 。 

所 有 章节 都 按照 最 新 版 本 的 Java 进行 了 修订 ， 过 时 的 材料 都 删除 了 ，Java SE 8 的 新 API 


也 都 详细 地 进行 了 讨论 。 
约定 


人 这 种 格式 在 众多 的 计算 机 书籍 中 极为 常见 。 各 种 图 
标的 含义 如 下 : 


注意 : 需要 引起 注意 的 地 方 。 
v1 提示 : 有 用 的 提示 。 
O 警告 : 关于 缺陷 或 危险 情况 的 警告 信息 。 


Q C++ 注意 : 本 书 中 有 许多 这 类 提示 ， 用 于 解释 Java 程序 设计 语言 和 C++ 语言 之 间 的 不 
同 。 如 果 你 对 这 部 分 不 感 兴趣 ， 可 以 跳 过 。 


Java 平台 配备 有 大 量 的 编程 类 库 或 者 应 用 编程 接口 (API)。 当 第 一 次 使 用 某 个 API AY, 
我 们 在 每 一 节 的 末尾 都 添加 了 一 个 简短 的 描述 。 这 些 描述 可 能 有 点 不 太 规范 ， 但 是 比 官 方 在 
线 API 文档 更 具 指 导 性 。 接 口 的 名 字 都 是 斜体 的 ， 就 像 许多 官方 文档 一 样 。 类 、 接 口 或 方法 
名 后 面 的 数字 是 IDK 的 版 本 ， 表 示 在 该 版 本 中 才 引 入 了 这 些 特 性 。 





UROL RM RATER TA. 例如 ， 





可 以 从 网 站 http://horstmann.com/corejava “下 载 示 例 代码 。 
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A 从 迭代 到 流 的 操作 A 收集 结果 

A 流 的 创建 A 收集 到 映射 表 中 
A filter, map 和 flatMap 方法 A 群 组 和 分 区 

A 抽取 子 流 和 连接 流 A Piece at 

A 其 他 的 流转 换 A 约 简 操作 

A fg ATA A 基本 类 型 流 

A Optional 类 型 全 并 行 流 


流 提供 了 一 种 让 我 们 可 以 在 比 集合 更 高 的 概念 级 别 上 指定 计算 的 数据 视图 。 通 过 使 用 
流 ， 我 们 可 以 说 明 想 要 完成 什么 任务 ， 而 不 是 说 明 如 何 去 实 现 它 。 我 们 将 操作 的 调度 留 给 具 
体 实 现 去 解决 。 例 如 ， 假 设 我 们 想 要 计算 某 个 属性 的 平均 值 ， 那 么 我 们 就 可 以 指定 数据 产 和 
该 属性 ， 然 后 ， 流 库 就 可 以 对 计算 进行 优化 ， 例 如 ， 使 用 多 线程 来 计算 总 和 与 个 数 ， 并 将 结 
果 合 并 。 

在 本 章 中 ， 你 将 会 学 习 如 何 使 用 Java 的 流 库 ， 它 是 在 Java SE 8 中 引入 的 ， 用 来 以 “做 
什么 而 非 怎 么 做 ”的 方式 处 理 集 合 。 


1.1 ”从 迭代 到 流 的 操作 


在 处 理 集合 时 ， 我 们 通常 会 迭代 遍历 它 的 元 素 ， 并 在 每 个 元 素 上 执行 某 项 操作 。 例 如 ， 
假设 我 们 想 要 对 某 本 书 中 的 所 有 长 单词 进行 计数 。 首 先 ， 将 所 有 单词 放 到 一 个 列表 中 : 


String contents = new String(Files. readAllBytes( 

Paths.get("alice.txt")), StandardCharsets.UTF_8); // Read file into string 
List<String> words = Arrays.asList(contents.split("\\PL+")) ; 

// Split into words; nonletters are delimiters 


现在 ,我 们 可 以 迭代 它 了 : 


long count = 0; 
for (String w : words) 


if (w.length() > 12) count++; 


在 使 用 流 时 ， 相 同 的 操作 看 起 来 像 下 面 这 样 : 


long count = words.stream() 
.filter(w -> w.length() > 12) 
„count C); 
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流 的 版 本 比 循环 版 本 要 更 易于 阅读 ， 因 为 我 们 不 必 扫 描 整 个 代码 去 查找 过 滤 和 计数 操 
作 ， 方 法 名 就 可 以 直接 告诉 我 们 其 代码 意欲 何 为 。 而 且 ， 循 环 需要 非常 详细 地 指定 操作 的 顺 
序 ， 而 流 却 能 够 以 其 想 要 的 任何 方式 来 调度 这 些 操作 ， 只 要 结果 是 正确 的 即 可 。 

仅 将 stream 修改 为 paralle1Stream 就 可 以 让 流 库 以 并 行 方式 来 执行 过 滤 和 计数 。 


long count = words.parallelStream() 
.filter(w -> w.length() > 12) 
.count(); 


流 齐 循 了 “做 什么 而 非 怎么 做 ”的 原则 。 在 流 的 示例 中 ， 我 们 描述 了 需要 做 什么 : 获取 
长 单词 ， 并 对 它们 计数 。 我 们 没有 指定 该 操作 应 该 以 什么 顺序 或 者 在 哪个 线程 中 执行 。 相 
比 之 下 ， 本 节 开 头 处 的 循环 要 确切 地 指定 计算 应 该 如 何 工 作 ， 因 此 也 就 南 失 了 进行 优化 的 
机 会 。 

流 表面 上 看 起 来 和 集合 很 类 似 ， 都 可 以 让 我 们 转换 和 获取 数据 。 但 是 ， 它 们 之 间 存 在 着 
显著 的 差异 : 

1. 流 并 不 存储 其 元 素 。 这 些 元 素 可 能 存储 在 底层 的 集合 中 ,或 者 是 按 需 生成 的 。 

2. 流 的 操作 不 会 修改 其 数据 源 。 例 如 ，fi1ter 方法 不 会 从 新 的 流 中 移 除 元 素 ， 而 是 会 
生成 一 个 新 的 流 ， 其 中 不 包含 被 过 滤 掉 的 元 素 。 

3. 流 的 操作 是 尽 可 能 惰性 执行 的 。 这 意味 着 直至 需要 其 结果 时 ， 操 作 才 会 执行 。 例 如 ， 
如 果 我 们 只 想 查 找 前 5 个 长 单词 而 不 是 所 有 长 单词 ， 那 么 filter 方法 就 会 在 匹配 到 第 5 个 
单词 后 停止 过 滤 。 因 此 ， 我 们 甚至 可 以 操作 无 限 流 。 

让 我 们 再 来 看 看 这 个 示例 。stream 和 parallelStream 方法 会 产生 一 个 用 于 words 列 
表 的 stream, filter 方法 会 返回 另 一 个 流 ， 其 中 只 包含 长 度 大 于 12 的 单词 。count 方法 
会 将 这 个 流 化 简 为 一 个 结果 。 

这 个 工作 流 是 操作 流 时 的 典型 流程 。 我 们 建立 了 一 个 包含 三 个 阶段 的 操作 管道 : 

1. 创建 一 个 流 。 

2. 指定 将 初始 流转 换 为 其 他 流 的 中 间 操 作 ， 可 能 包含 多 个 步骤 。 

3. 应 用 终止 操作 ， 从 而 产生 结果 。 这 个 操作 会 强制 执行 之 前 的 惰性 操作 。 从 此 之 后 ， 这 
个 流 就 再 也 不 能 用 了 。 

在 程序 清单 1-1 中 的 示例 中 ， 流 是 用 stream 或 parallelStream 方法 创建 的 。fi1ter 
方法 对 其 进行 转换 ， 而 count 方法 是 终止 操作 。 





package streams; 


import java.io. IOException; 

import java.nio.charset.StandardCharsets; 
import java.nio. file. Files; 

import java.nio. file. Paths; 

import java.util.Arrays; 

import java.util.List; 


Co oo N ER n A u N j 
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10 public class CountLongWords 


u { 

12 public static void main(String[] args) throws I0Exception 

13 { 

14 String contents = new String(Files, readAllBytes( 

15 Paths .get("../gutenberg/alice30.txt")), StandardCharsets.UTF_8) ; 
16 List<String> words = Arrays.asList(contents.split("\\PL+")) ; 
17 

18 long count = 0; 

19 for (String w : words) 

20 { 

21 if (w.Jength() > 12) count++; 

22 

23 System. out.printIn(count) ; 

24 

25 count = words.stream().filter(w -> w.length() > 12).count(); 
26 System. out.print]n(count) ; 

27 

28 count = words.parallelStream().filter(w -> w.length() > 12).count(); 
29 System. out.printIn(count) ; 

30 } 

31 } 





在 下 一 节 中 ， 你 将 会 看 到 如 何 创建 流 。 后 续 的 三 个 小 节 将 处 理 流 的 转换 。 再 后 面 的 五 个 
小 节 将 讨论 终止 操作 。 





e Stream<T> filter(Predicate<? super T> p) 


产生 一 个 流 ， 其 中 包含 当前 流 中 满足 P 的 所 有 元 素 。 


è long count() 


产生 当前 流 中 元 素 的 数量 。 这 是 一 个 


终止 操作 。 





edefault Stream<E> stream( ) 
e default Stream<E> parallelStream() 


产生 当前 集合 中 所 有 元 素 的 顺序 流 或 并 行 流 。 


1.2 AWA 


你 已 经 看 到 了 可 以 用 Collection 接口 的 stream 方法 将 任何 集合 转换 为 一 个 流 。 如 采 
你 有 一 个 数组 ， 那 么 可 以 使 用 静态 的 Stream.of 方法 。 


Stream<String> words = Stream.of(contents.split("\\PL+")) ; 
// split returns a String[] array 


of 方法 具有 可 变 长 参数 ， 因 此 我 们 可 以 构建 具有 任意 数量 引 元 的 流 : 
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Stream<String> song = Stream.of("gently", "down", "the", "stream"): 

使 用 Array.stream(array, from, to) 可 以 从 数组 中 位 于 from (包括 ) 和 to (AA 
括 ) 的 元 素 中 创建 一 个 流 。 

为 了 创建 不 包含 任何 元 素 的 流 ， 可 以 使 用 静态 的 Stream.empty 方法 : 


Stream<String> silence = Stream.empty(); 
// Generic type <String> is inferred; same as Stream.<String>empty() 


Stream 接口 有 两 个 用 于 创建 无 限 流 的 静态 方法 。generate 方法 会 接受 一 个 不 包含 任何 
引 元 的 函数 (或 者 从 技术 上 讲 ， 是 一 个 Supplier<T> 接口 的 对 象 )。 无 论 何 时 ， 只 要 需要 一 个 
流 类 型 的 值 ， 该 函数 就 会 被 调用 以 产生 一 个 这 样 的 值 。 我 们 可 以 像 下 面 这 样 获 得 一 个 常量 值 
的 流 : 

Stream<String> echos = Stream.generate(() -> "Echo"); 

或 者 像 下 面 这 样 获 取 一 个 随机 数 的 流 : 

Stream<Double> randoms = Stream.generate(Math: : random) ; 

为 了 产生 无 限 序列 ， 例 如 0 1 2 3 …， 可 以 使 用 iterate 方法 。 它 会 接受 一 个 “种 子 ” 
值 ， 以 及 一 个 函数 (从 技术 上 讲 ， 是 一 个 UnaryOperation<T>)， 并 且 会 反复 地 将 该 函数 应 用 
到 之 前 的 结果 上 。 例 如 ， 


Stream<BigInteger> integers 
= Stream.iterate(BigInteger.ZERO, n -> n.add(BigInteger.ONE)); 


该 序列 中 的 第 一 个 元 素 是 种 子 BigInteger .ZERO， 第 二 个 元 素 是 f(seed)， 即 1 (作为 
大 整数 )， 下 一 个 元 素 是 f(f(seed) )， 即 2， 后 续 以 此 类 推 。 
注意 : Java API 中 有 大 量 方法 都 可 以 产生 流 。 例 如 ，Pattern 类 有 一 个 sp1itAsStream 
方法 ， 它 会 按照 某 个 正则 表达 式 来 分 割 一 个 CharSequence 对 象 。 可 以 使 用 下 面 的 语句 
来 将 一 个 字符 串 分 割 为 一 个 个 的 单词 : 
Stream<String> words = Pattern.compile("\\PL+").splitAsStream(contents) ; 
静态 的 Files.1ines 方法 会 返回 一 个 包含 了 文件 中 所 有 行 的 Stream: 


try (Stream<String> lines = Files,lines(path)) 


Process lines 


程序 清单 1-2 中 的 示例 程序 展示 了 创建 流 的 各 种 方式 。 





package streams; 


import java.math. BigInteger; 
import java.nio.charset.StandardCharsets; 


1 
2 
3 import java.io. IOException; 
4 
5 
6 import java.nio.file.Files; 








1# Java SE8 KÆ 5 


7 import java.nio. file. Path; 

8 import java.nio.file. Paths; 

9 import java.util.List; 

10 import java.util. regex.Pattern; 

11 import java.util.stream.Collectors; 
12 Import java.util.stream. Stream; 


14 public class CreatingStreams 
is { 


16 public static <T> void show(String title, Stream<T> stream) 


{ 
18 final int SIZE = 10; 


19 List<T> firstElements = stream 

20 ,]imit(9IZE + 1) 

21 .collect(Collectors.toList()); 

22 System.out.print(title +": "); 

23 for (int i = 0; i < firstElements.size(); i++) 
24 

25 if (1 > 0) System.out.print(", "); 

26 if (i < SIZE) System.out.print(firstElements.get(i)); 
27 else System.out.print("..."); 

28 } 

29 System.out.printIn(); 


32 public static void main(String{] args) throws IOException 


33 { 

34 Path path = Paths.get("../gutenberg/alice30. txt"); 

35 String contents = new String(Files.readAl l]Bytes(path) , 

36 StandardCharsets .UTF_8) ; 

37 

38 Stream<String> words = Stream.of(contents.split("\\PL+")); 

39 Show("words", words); 

40 Stream<String> song = Stream.of("gently", "down", "the", "stream"); 
41 Show("song", song); 

42 Stream<String> silence = Stream.empty(); 

43 show("silence", silence); 

44 

45 Stream<String> echos = Stream.generate(() -> “Echo"); 

46 show("echos", echos); 

47 

48 Stream<Double> randoms = Stream.generate(Math: : random) ; 

49 show("randoms", randoms) ; 

50 

51 Stream<BigInteger> integers = Stream. iterate(BigInteger. ONE, 

52 n -> n.add(BigInteger.ONE)); 

53 show("integers", integers); 

54 

55 Stream<String> wordsAnotherWay = Pattern. compi le("\\PL+").splitAsStream( 
56 contents) ; 

57 show("wordsAnotherWay", wordsAnotherWay) ; 

58 

59 try (Stream<String> lines = Files.lines(path, StandardCharsets.UTF_8)) 


60 { 
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61 show("lines", lines); 






e static <T> Stream<T> of(T... values) 

产生 一 个 元 素 为 给 定 值 的 流 。 

e static <T> Stream<T> empty() 

产生 一 个 不 包含 任何 元 素 的 流 。 

estatic <T> Stream<T> generate(Supplier<T> s) 

产生 一 个 无 限 流 ， 它 的 值 是 通过 反复 调用 函数 s 而 构建 的 。 

e static <T> Stream<T> iterate(T seed, UnaryOperator<T> f) 

产生 一 个 无 限 流 ， 它 的 元 素 包含 种 子 、 在 种 子 上 调用 f 产 生 的 值 、 在 前 一 个 元 素 上 调 
用 ff 产生 的 值 ， 等 等 。 









e static <T> Stream<T> stream(T[] array, int startInclusive, int endExclusive) 8 


产生 一 个 流 ， 它 的 元 素 是 由 数组 中 指定 范围 内 的 元 素 构成 的 。 





e Stream<String> splitAsStream(CharSequence input) 8 


产生 一 个 流 ， 它 的 元 素 是 输入 中 由 该 模式 界定 的 部 分 。 














e static Stream<String> lines(Path path) 8 

e static Stream<String> lines(Path path, Charset cs) 8 

产生 一 个 流 ， 它 的 元 素 是 指定 文件 中 的 行 ， 该 文件 的 字符 集 为 UTF-8， 或 者 为 指定 的 
字符 集 。 





eT get() 
提供 一 个 值 o 


1.3 filter, map 和 flatMap 方法 


流 的 转换 会 产生 一 个 新 的 流 ， 它 的 元 素 派生 自 男 一 个 流 中 的 元 素 。 我 们 已 经 看 到 了 
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filter 转换 会 产生 一 个 流 ， 它 的 元 素 与 某 种 条 件 相 匹配 。 下 面 ， 我 们 将 一 个 字符 串 流转 换 
为 了 只 包含 长 单词 的 为 一 个 流 : 


List<String> wordList =... .; 
Stream<String> longWords = wordList.stream().filter(w -> w.length() > 12); 


filter 的 引 元 是 Predicate<T>, BI MT 到 boolean W AŽ 
通常 ， 我 们 想 要 按照 某 种 方式 来 转换 流 中 的 值 ， 此 时 ， 可 以 使 用 map 方法 并 传递 执行 该 
转换 的 函数 。 例 如 ， 我 们 可 以 像 下 面 这 样 将 所 有 单词 都 转换 为 小 写 : 


Stream<String> lowercaseWords = words.stream() .map(String: :toLowerCase) ; 


这 里 ， 我 们 使 用 的 是 带 有 方法 引用 的 map, 但 是 ,通常 我 们 可 以 使 用 lambda 表达 式 来 
(Ve : 


Stream<String> firstLetters = words.stream().map(s -> s.substring(0, 1)); 


上 面 语 句 所 产生 的 流 中 包含 了 所 有 单词 的 首 字 母 。 

在 使 用 map 时 ,会 有 一 个 函数 应 用 到 每 个 元 素 上 ， 并 且 其 结果 是 包含 了 应 用 该 函数 后 所 
产生 的 所 有 结果 的 流 。 现 在 ， 假 设 我 们 有 一 个 函数 ， 它 返回 的 不 是 一 个 值 ， 而 是 一 个 包含 众 
多 值 的 流 : 

public static Stream<String> letters(String s) 

List<String> result = new ArrayList<>(); 
for (int i = 0; i < s.length(); i++) 

result.add(s.substring(i, 1 + 1)); 
return result.stream() ; 


} 
例如 , letters( "boat" ) 的 返回 值 是 流 ["b", sar, wan. eel 
注意 : 通过 使 用 1.13 节 中 的 IntStream.range 方法 ， 我 们 实现 这 个 方法 可 以 优雅 得 多 。 
假设 我 们 在 一 个 字符 串 流 上 映射 1etters 方法 : 
Stream<Stream<String>> result = Words,stream() .map(W -> letters(w)); 
那么 就 会 得 到 一 个 包含 流 的 流 ， 就 像 Cea a de 人 | 为 了 将 其 捧 
平 为 字母 流 | 可 以 使 用 f] atMap 方法 而 不 是 map 方法 : 
Stream<String> flatResult = words.stream().flatMap(w -> letters (w)) 
// Calls letters on each word and flattens the results 
注意 : 在 流 之 外 的 类 中 你 也 会 发 现 flatMap 方法 ， 因 为 它 是 计算 机 科学 中 的 一 种 通用 概 
念 。 假 设 我 们 有 一 个 泛 型 G (例如 Stream)， 以 及 将 某 种 类 型 T 转换 为 G<U> 的 函数 了 和 
将 类 型 U 转换 为 G<V> 的 函数 g。 然 后 ， 我 们 可 以 通过 使 用 flatMap ASCH, PPA 
先 应 用 下 ， 然 后 应 用 g。 这 是 单子 论 的 关键 概念 。 但 是 不 必 担 心 ， 我 们 无 须 了 解 任何 有 
关 单 子 的 知识 就 可 以 使 用 flatMap。 
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e Stream<T> filter(Predicate<? super T> predicate) 
产生 一 个 流 ， 它 包含 当前 流 中 所 有 满足 断言 条 件 的 元 素 。 

e <R> Stream<R> map(Function<? super T,? extends R> mapper) 
产生 一 个 流 ， 它 包含 将 mapper 应 用 于 当前 流 中 所 有 元 素 所 产生 的 结果 。 

e <R> Stream<R> flatMap(Function<? super T,? extends Stream<? extends R>> mapper) 
产生 一 个 流 ， 它 是 通过 将 mapper 应 用 于 当前 流 中 所 有 元 素 所 产生 的 结果 连接 到 一 起 
而 获得 的 。( 注 意 ， 这 里 的 每 个 结果 都 是 一 个 流 。) 


1.4 ”抽取 子 流 和 连接 流 


调用 stream.1imit(n) 会 返回 一 个 新 的 流 ， 它 在 n 个 元 素 之 后 结束 (如果 原来 的 流 更 
短 ， 那 么 就 会 在 流 结束 时 结束 )。 这 个 方法 对 于 裁 前 无限 流 的 尺寸 会 显得 特别 有 用 。 例 如 ， 


Stream<Double> randoms = Stream.generate(Math::random) .1imit(100) ; 


会 产生 一 个 包含 100 个 随机 数 的 流 。 

调用 stream.skip(n) 正好 相反 : 它 会 丢弃 前 n 个 元 素 。 这 个 方法 在 将 文本 分 隔 为 单词 
时 会 显得 很 方便 ， 因 为 按照 split 方法 的 工作 方式 ， 第 一 个 元 素 是 没什么 用 的 空 字 符 串 。 我 
们 可 以 通过 调用 skip 来 跳 过 它 : 

Stream<String> words = Stream.of(contents.split("\\PL+")).skip(1); 


我 们 可 以 用 Stream 类 的 静态 的 concat 方法 将 两 个 流连 接 起 来 : 


Stream<String> combined = Stream,Concat( 
letters("Hello"), letters("World")); 
// Yields the stream ("H", "e", K a ae "o", "W", "o", W w "d"] 


当然 ， 第 一 个 流 不 应 该 是 无 限 的 ， 否 则 第 二 个 流 永远 都 不 会 得 到 处 理 的 机 会 。 








e Stream<T> limit(long maxSize) 
产生 一 个 流 ， 其 中 包含 了 当前 流 中 最 初 的 maxSize 个 元 素 。 

e Stream<T> skip(long n) 
产生 一 个 流 ， 它 的 元 素 是 当前 流 中 除了 前 n 个 元 素 之 外 的 所 有 元 素 。 


e static <T> Stream<T> concat(Stream<? extends T> a, Stream<? extends T> b) 


产生 一 个 流 ， 它 的 元 素 是 a 的 元 素 后 面 跟着 b 的 元 素 。 


1.5 “其 他 的 流转 换 
distinct 方法 会 返回 一 个 流 ， 它 的 元 素 是 从 原 有 流 中 产生 的 ， 即 原来 的 元 素 按照 同样 
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的 顺序 剔除 重复 元 素 后 产生 的 。 这 个 流 显然 能 够 记 住 它 已 经 看 到 过 的 元 素 。 


Stream<String> uniqueWords 
= Stream.of("merrily", "merrily", "merrily", "gently").distinct(); 
// Only one "merrily" is retained 


对 于 流 的 排序 ， 有 多 种 sorted 方法 的 变 体 可 用 。 其 中 一 种 用 于 操作 Comparable 元 素 
的 流 ， 而 另 一 种 可 以 接受 一 个 Comparator。 下 面 ， 我 们 对 字符 串 排 序 ， 使 得 最 长 的 字符 串 
排 在 最 前 面 : 


Stream<String> longestFirst = 
words.stream().sorted(Comparator.comparing(String:: length). reversed()) ; 


与 所 有 的 流转 换 一 样 ，sorted 方法 会 产生 一 个 新 的 流 ， 它 的 元 素 是 原 有 流 中 按照 顺序 
排列 的 元 素 。 

当然 ， 我 们 在 对 集合 排序 时 可 以 不 使 用 流 。 但 是 ， 当 排序 处 理 是 流 管道 的 一 部 分 时 ， 
sorted 方法 就 会 显得 很 有 用 。 

最 后 ，peek 方法 会 产生 另 一 个 流 ， 它 的 元 素 与 原来 流 中 的 元 素 相 同 ， 但 是 在 每 次 获取 一 
个 元 素 时 ， 都 会 调用 一 个 孔 数 。 这 对 于 调试 来 说 很 方便 : 


Object[] powers = Stream.iterate(1.0, p -> p * 2) 
,peek(e -> System.out.printin("Fetching " + e)) 
.limit(20). toArray() ; 


当 实际 访问 一 个 元 素 时 ， 就 会 打印 出 来 一 条 消息 。 通 过 这 种 方式 ， 你 可 以 验证 iterate 


返回 的 无 限 流 是 被 惰性 处 理 的 。 
对 于 调试 ， 你 可 以 让 peek 调用 一 个 你 


设置 了 断 点 的 方法 。 





e Stream<T> distinct() 
产生 一 个 流 ， 包 含 当前 流 中 所 有 不 同 的 元 素 。 

e Stream<T> sorted() 

e Stream<T> sorted(Comparator<? super T> comparator) 
产生 一 个 流 ， 它 的 元 素 是 当前 流 中 的 所 有 元 素 按照 顺序 排列 的 。 第 一 个 方法 要 求 元 素 
是 实现 了 Comparable 的 类 的 实例 。 

e Stream<T> peek(Consumer<? super T> action) 


产生 一 个 流 ， 它 与 当前 流 中 的 元 素 相同 ， 在 获取 其 中 每 个 元 素 时 ， 会 将 其 传递 给 action. 


1.6 ”简单 约 简 
现在 你 已 经 看 到 了 如 何 创 建 和 转换 流 ， 我 们 终于 可 以 讨论 最 重要 的 内 容 了 ， 即 从 流 


数据 中 获得 答案 。 我 们 在 本 节 所 讨论 的 方法 被 称 为 约 简 。 约 简 是 一 种 终结 操作 (terminal 
operation)， 它 们 会 将 流 约 简 为 可 以 在 程序 中 使 用 的 非 流 值 。 
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你 已 经 看 到 过 一 种 简单 约 简 : count 方法 会 返回 流 中 元 素 的 数量 。 

其 他 的 简单 约 简 还 有 max 和 min， 它 们 会 返回 最 大 值 和 最 小 值 。 这 里 要 稍 作 解释 ， 这 些 
方法 返回 的 是 一 个 类 型 0ptiona1<T> 的 值 ， 它 要 么 在 其 中 包装 了 答案 ， 要 人 么 表示 没有 任何 
值 (因为 流 碰巧 为 空 )。 在 过 去 ， 碰 到 这 种 情况 返回 nul) 是 很 常见 的 ， 但 是 这 样 做 会 导致 在 
未 做 完备 测试 的 程序 中 产生 空 指针 异常 。0ptional 类 型 是 一 种 更 好 的 表示 缺少 返回 值 的 方 
式 。 我 们 将 在 下 一 节 中 详细 讨论 Optional 类 型 。 下 面 展示 了 可 以 如 何 获得 流 中 的 最 大 值 : 


Optional<String> largest = words.max(String: :compareTolgnoreCase) ; 
System.out.printIn("largest: " + largest.orElse("")); 


findFirst 返回 的 是 非 空 集合 中 的 第 一 个 值 。 它 通常 会 在 与 filter 组 合 使 用 时 显得 很 有 
用 。 例 如 ， 下 面 展示 了 如 何 找到 第 一 个 以 字母 Q 开头 的 单词 ， 前 提 是 存在 这 样 的 单词 

Optional<String> startsWithQ = words.filter(s -> s.startsWith("Q")).findFirstQ) ; 

如 果 不 强 调 使 用 第 一 个 匹配 ， 而 是 使 用 任意 的 匹配 都 可 以 ， 那 么 就 可 以 使 用 findAny 
方法 。 这 个 方法 在 并 行 处 理 流 时 会 很 有 效 ， 因 为 流 可 以 报告 任何 它 找 到 的 匹配 而 不 是 被 限制 
为 必须 报告 第 一 个 匹配 。 

Optional<String> startsWithQ = words.parallel().filter(s -> s.startsWith("Q")).findAny(); 

如 果 只 想 知道 是 否 存在 匹配 ， 那 么 可 以 使 用 anyMatch。 这 个 方法 会 接受 一 个 断言 引 元 ， 
因此 不 需要 使 用 filter, 

boolean aWordStartsWithQ = words.parallel().anyMatch(s -> s,startsWith("Q")); 

还 有 allMatch 和 noneMatch 方法 ,它们 分 别 会 在 所 有 元 素 和 没有 任何 元 素 匹 配 断 言 
的 情况 下 返回 true。 这 些 方法 也 可 以 通过 并 行 运 行 而 获 益 。 





e Optional<T> max(Comparator<? super T> comparator) 


e Optional<T> min(Comparator<? super T> comparator) 
分 别 产 生 这 个 流 的 最 大 元 素 和 最 小 元 素 ， 使 用 由 给 定 比 较 器 定义 的 排序 规则 ， 如 果 这 
个 流 为 空 ， 会 产生 一 个 空 的 0ptional 对 象 。 这 些 操作 都 是 终结 操作 。 

e Optional<T> findFirst() 

e Optional<T> findAny( ) 
分 别 产生 这 个 流 的 第 一 个 和 任意 一 个 元 素 ， 如 果 这 个 流 为 空 ， 会 产生 一 个 空 的 
Optional 对 象 。 这 些 操作 都 是 终结 操作 。 

e boolean anyMatch(Predicate<? super T> predicate) 

èe boolean allMatch(Predicate<? super T> predicate) 

e boolean noneMatch(Predicate<? super T> predicate) 
分 别 在 这 个 流 中 任意 元 素 、 所 有 元 素 和 没有 任何 元 素 匹 配给 定 断 言 时 返回 true。 这 些 
操作 都 是 终结 操作 。 
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1.7 Optional 类 型 


Optional<T> 对 象 是 一 种 包装 器 对 象 ， 要 么 包装 了 类 型 了 的 对 象 ， 要 么 没有 包装 任何 
对 象 。 对 于 第 一 种 情况 ， 我 们 称 这 种 值 为 存在 的 。0ptiona1<T> 类 型 被 当 作 一 种 更 安全 的 方 
式 ， 用 来 替代 类 型 T 的 引用 ， 这 种 引用 要 么 引用 某 个 对 象 ， 要 人 么 为 nu11。 但 是 ， 它 只 有 在 
正确 使 用 的 情况 下 才 会 更 安全 ， 下 一 节 我 们 将 讨论 如 何 正 确 使 用 。 


1.7.1 如 何 使 用 Optional 值 


有 效 地 使 用 Optional 的 关键 是 要 使 用 这 样 的 方法 : 它 在 值 不 存在 的 情况 下 会 产生 一 个 
可 替代 物 ， 而 只 有 在 值 存 在 的 情况 下 才 会 使 用 这 个 值 。 

让 我 们 来 看 看 第 一 条 策略 。 通 常 ， 在 没有 任何 匹配 时 ， 我 们 会 希望 使 用 某 种 默认 值 ， 可 
能 是 空 字符 串 : 


String result = optionalString.orElse("") ; 
// The wrapped string, or "" if none 


你 还 可 以 调用 代码 来 计算 默认 值 : 


String result = optionalString.orElseGet(() -> Locale. getDefault() .getDisplayName()) ; 
// The function is only called when needed 


或 者 可 以 在 没有 任何 值 时 抛 出 异常 : 


String result = optionalString.orElseThrow(IllegalStateException: :new) ; 
// Supply a method that yields an exception object 


sR NT a AN APE A A A BPE. AREH i AB 
略 是 只 有 在 其 存在 的 情况 下 才 消 费 该 值 。 

ifPresent 方法 会 接受 一 个 函数 。 如 果 该 可 选 值 存在 ， 那 么 它 会 被 传递 给 该 阴 数 。 否 
则 ， 不 会 发 生 任 何事 情 。 

optionalValue.ifPresent(v -> Process v); 

例如 ， 如 果 在 该 值 存在 的 情况 下 想 要 将 其 添加 到 某 个 集中 ,那么 就 可 以 调用 

optionalValue.ifPresent(v -> results.add(v)) ; 

或 者 直接 调用 

optionalValue.ifPresent (results: :add) ; 

当 调用 ifPresent 时 ， 从 该 函数 不 会 返回 任何 值 。 如 果 想 要 处 理 函 数 的 结果 ， 应 该 使 
用 map; 

Optional<Boolean> added = optionalValue.map(resul ts: : add) ; 

现在 added 具有 三 种 值 之 一 : 在 optionalValue 存在 的 情况 下 包装 在 Optional 中 的 
true a false, LIME optionalValue 不 存在 的 情况 下 的 空 Optional1。 


/ 
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注意 : 这 个 map 方法 与 1.3 节 中 描述 的 Stream 接口 的 map 方法 类 似 。 你 可 以 直接 将 可 选 值 
想象 成 尺寸 为 0 或 1 的 流 。 结 果 的 尺寸 也 是 0 或 1， 并且 在 后 一 种 情况 中 ， 会 应 用 到 函数 。 





eT orElse(T other) 
产生 这 个 Optional 的 值 ， 或 者 在 该 Optional 为 空 时 ， 产 生 other, 

e T orElseGet(Supplier<? extends T> other) 
产生 这 个 Optional 的 值 ， 或 者 在 该 Optional 为 空 时 ， 产 生 调用 other 的 结果 。 

e <X extends Throwable> T orElseThrow(Supplier<? extends X> exceptionSupplier) 
产生 这 个 Optional 的 值 ， 或 者 在 该 Optional 为 空 时 ， 抛 出 调用 exceptionSupplier 
的 结果 。 


evoid ifPresent(Consumer<? super T> consumer) 
如 采 该 Optional 不 为 空 ， 那 么 就 将 它 的 值 传递 给 consumer, 

e <U> Optional<U> map(Function<? super T,? extends U> mapper ) 
产生 将 该 0ptional 的 值 传 递 给 mapper 后 的 结果 ， 只 要 这 个 Optional 不 为 空 且 结 
来 不 为 nu11， 和 否则 产生 一 个 空 Optional, 


1.7.2 不 适合 使 用 Optional 值 的 方式 


如 果 没 有 正确 地 使 用 0ptional 值 ， 那 么 相 比 较 以 往 的 得 到 “ 某 物 或 nu11” 的 方式 ， 
你 并 没有 得 到 任何 好 处 。 

get 方法 会 在 0ptional 值 存在 的 情况 下 获得 其 中 包装 的 元 素 ， 或 者 在 不 存在 的 情况 下 
抛 出 一 个 NoSuchElementException 对 象 。 因 此 ， 


Optional<T> optionalValue = ，，,， 
optionalValue.get().someMethod() ; 


并 不 比 下 面 的 方式 更 安全 : 


T value = ，，,， 
value. someMethod() ， 


isPresent 方法 会 报告 某 个 0ptiona1<T> 对 象 是 否 具有 一 个 值 。 但 是 
if (optionalValue.isPresent()) optionalValue.get().someMethod() : 


并 不 比 下 面 的 方式 更 容易 处 理 : 


if (value != null) value,someMethod() ， 





eT get() 
产生 这 个 Optional 的 值 ， 或 者 在 该 Optional 为 空 时 ， 抛 出 一 个 NoSuchElementException 


对 象 。 
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e boolean isPresent() 
如 果 该 Optional 不 为 空 ， 则 返回 true, 


1.7.3 创建 Optional 值 


到 目前 为 止 ， 我 们 已 经 讨论 了 如 何 使 用 其 他 人 创建 的 0ptional 对 象 。 如 果 想 要 编写 方 
法 来 创建 Optional 对 象 ， 那 么 有 多 个 方法 可 以 用 于 此 目的 ,包括 Optional.of(result) 
Ail Optional.empty(), #40, 


public static Optional<Double> inverse(Double x) 


{ 
return x == 0 ? Optional.empty() : Optional.of(1 / x); 


} 

ofNu11able 方 法 被 用 来 作为 可 能 出 现 的 nu11 值 和 可 选 值 之 间 的 桥架 。0optional . 
ofNullable(obj) 会 在 obj 不 为 nu11 的 情况 下 返回 0ptional.of(obj)， 否则 会 返回 
Optional.empty(), 





estatic <T> Optional<T> of(T value) 

estatic <T> Optional<T> ofNullable(T value) 
产生 一 个 具有 给 定 值 的 0ptiona1。 如 果 value 为 nu11， 和 那么 第 一 个 方法 会 抛 出 一 个 
Nu11PointerException 对 象 ， 而 第 二 个 方法 会 产生 一 个 空 0ptional。 

e static <T> Optional<T> empty() 
产生 一 个 空 Optional, 


1.7.4 用 flatMap 来 构建 Optional 值 的 函数 


假设 你 有 一 个 可 以 产生 Optional<T> 对 象 的 方法 f， 并且 目 标 类 型 T 具 有 一 个 可 以 产 
Æ Optional<U> 对 象 的 方法 g。 如 果 它 们 都 是 普通 的 方法 ， 那 么 你 可 以 通过 调用 s.f().g() 
来 将 它们 组 合 起 来 。 但 是 这 种 组 合 没 法 工作 ， 因 为 s.f() 的 类 型 为 0ptional<T>， 而 不 是 
T。 因 此 ， 需 要 调用 : 

Optional<U> result = s.f().flatMap(T::9) ; 

如 果 s.fO 的 值 存 在 ， 那么 g 就 可 以 应 用 到 它 上 面 。 否 则 ， 就 会 返回 一 个 空 Optiona1<U>。 

很 明显 ， 如 果 有 更 多 的 可 以 产生 Optional 值 的 方法 或 Lambda 表达 式 ， 那 么 就 可 以 重 
复 此 过 程 。 你 可 以 直接 将 对 flatMap 的 调用 链接 起 来 ， 从 而 构建 由 这 些 步骤 构成 的 管道 ， 
只 有 所 有 步骤 都 成 功 时 ， 该 管道 才 会 成 功 。 

例如 ， 考 虑 前 一 节 中 安全 的 inverse 方法。 假设 我 们 还 有 一 个 安全 的 平方 根 : 


public static Optional<Double> squareRoot (Double x) 


{ 
return x < 0 ? Optional.empty() : Optional .of (Math. sqrt(x)); 


} 
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那么 你 可 以 像 下 面 这 样 计算 倒数 的 平方 根 了 : 

Optional<Double> result = inverse(x).flatMap(MyMath: :squareRoot) ; 

或 者 ， 你 可 以 选择 下 面 的 方式 : 

Optional<Double> result = Optional ,of(-4,0) .flatMap(MyMath: :inverse) ,flatMap(MyMath: :squareRoot) ; 

无 论 是 inverse 方法 还 是 squareRoot 方法 返回 0ptiona1.empty()， 整 个 结果 都 会 为 空 。 
注意 : 你 已 经 在 Stream 接口 中 看 到 过 flatMap 方法 (参见 1.3 节 )， 当 时 这 个 方法 被 用 

来 将 可 以 产生 流 的 两 个 方法 组 合 起 来 ， 其 实现 方式 是 摊 平 由 流 构成 的 流 。 如 果 将 可 选 值 

当 作 尺寸 为 0 和 1 的 流 来 解释 ， 那么 Optional.flatMap 方法 与 其 操作 方式 一 样 。 


程序 清单 1-3 中 的 示例 程序 演示 了 Optional API 的 使 用 方式 。 





package optional; 


1 

2 

3 Import java.io.*; 

4 import java.nio.charset.*; 

5 import java.nio.file.*; 

6 import java.util. *; 

7 

8 public class OptionalTest 

9 { 

10 public static void main(String[] args) throws IOException 

11 

12 String contents = new String(Files. readAl ]Bytes( 

13 Paths.get("../gutenberg/alice30.txt")), StandardCharsets.UTF_8); 
14 List<String> wordList = Arrays.asList(contents.split("\\PL+")); 

15 

16 Optional<String> optionalValue = wordList.stream() 

17 „filter(s -> s.contains("fred")) 

18 ,有 ndFirst 人) ; 

19 System.out.println(optionalValue.orElse("No word") + " contains fred"); 
20 

21 Optional<String> optionalString = Optional.empty(); 

22 String result = optionalString.orE]se("N/A"); 

23 System.out.printIn("result: " + result); 

24 result = optionalString.orElseGet(() -> Locale. getDefault() .getDisplayName()); 
25 System.out.printin("result: ”+ result); 

26 try 

27 { 

28 result = optional String.orE]seThrow(I]]egalStateException: :new) ; 
29 System.out.printIn("result: " + result); 

30 

31 catch (Throwable t) 

32 { 

33 t.printStackTrace(); 

34 } 

35 


36 optionalValue = wordList.stream() 
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37 „filter(s -> s.contains("red")) 

38 .findFirstQ) ; 

39 optionalValue.ifPresent(s -> System.out.printIn(s + " contains red")); 
40 

41 Set<String> results = new HashSet<>() ; 

42 optionalValue.ifPresent (results: : add) ; 

43 Optional<Boolean> added = optionalValue.map(results: :add) ; 

44 System. out.print]n(added) ; 

45 

46 System. out.printIn(inverse(4.0).flatMap(OptionalTest: :squareRoot)) ; 
47 System. out.print]n(inverse(-1.0).flatMap (Optional Test: :squareRoot)) ; 
48 System. out.print]n(inverse(0.0).flatMap (Optional Test: : squareRoot)) ; 
49 Optional<Double> result2 = Optional .of(-4.0) 

50 .flatMap (Optional Test: :inverse) . flatMap(Optional Test: :squareRoot) ; 
51 System.out.printIn(result2) ; 

52 } 

53 

54 public static Optional<Double> inverse(Double x) 

55 { 

56 return x == 0 ? Optional.empty() : Optional.of(1 / x); 

57 } 

58 

59 public static Optional<Double> squareRoot (Double x) 

60 { 

61 return x < 0 ? Optional.empty() : Optional .of(Math.sqrt(x)); 





e <U> Optional<U> flatMap(Function<? super T,Optional<U>> mapper ) 
产生 将 mapper 应 用 于 当前 的 Optional 值 所 产生 的 结果 ， 或 者 在 当前 Optional 为 
空 时 ， 返 回 一 个 空 0ptional1。 


1.8 收集 结果 


当 处 理 完 流 之 后 ， 通 常会 想 要 查看 其 元 素 。 此 时 可 以 调用 iterator 方法 ， 它 会 产生 可 
以 用 来 访问 元 素 的 旧式 风格 的 迭代 絮 。 

或 者 ， 可 以 调用 forEach 方法 ， 将 某 个 函数 应 用 于 每 个 元 素 : 

stream. forEach(System,out: :printin), 

在 并 行 流 上 ，forEach 方法 会 以 任意 顺序 遍历 各 个 元 素 。 如 果 想 要 按照 流 中 的 顺序 来 处 
理 它们 ， 可 以 调用 forEachordered 方法 。 当 然 ， 这 个 方法 会 丧失 并 行 处 理 的 部 分 甚至 全 部 
优势 。 

但 是 ， 更 常见 的 情况 是 ， 我 们 想 要 将 结果 收集 到 数据 结构 中 。 此 时 ， 可 以 调用 toArray， 
获得 由 流 的 元 素 构 成 的 数组 。 
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因为 无 法 在 运行 时 创建 泛 型 数组 ， 所 以 表达 式 stream. toArray() 会 返回 一 个 0bject[] 
数组 。 如 果 想 要 让 数组 具有 正确 的 类 型 ， 可 以 将 其 传递 到 数组 构造 器 中 


String[] result = stream. toArray(String[] : :new); 
// stream.toArray() has type Object[] 


针对 将 流 中 的 元 素 收集 到 另 一 个 目标 中 ， 有 一 个 便捷 方法 collect 可 用 ， 它 会 接受 一 个 
Collector 接口 的 实例 。Co1l1ectors 类 提供 了 大 量 用 于 生成 公共 收集 器 的 工厂 方法 。 为 了 
将 流 收集 到 列表 或 集中 ， 可 以 直接 调用 

List<String> result = stream.collect(Collectors. tolist()): 

或 

Set<String> result = stream.collect(Collectors.toSet()); 

如 采 想 要 控制 获得 的 集 的 种 类 ， 那 么 可 以 使 用 下 面 的 调用 : 

TreeSet<String> result = stream.collect(Collectors.toCollection(TreeSet: :new)); 

假设 想 要 通过 连接 操作 来 收集 流 中 的 所 有 字符 串 。 我 们 可 以 调用 

String result = stream.collect(Collectors.joining()); 

如 有 果 想 要 在 元 素 之 间 增 加 分 隔 符 ， 可 以 将 分 隔 符 传 递 给 joining 方法 : 

String result = stream.collect(Collectors.joining(", ")); 

如 条 流 中 包含 除 字 符 串 以 外 的 其 他 对 象 ， 那 么 我 们 需要 现 将 其 转换 为 字符 串 ， 就 像 下 面 
这 样 : 

String result = stream.map(Object::toString).collect(Collectors.joining(", ")); 

如 采 想 要 将 流 的 结果 约 简 为 总 和 、 平 均值 、 最 大 值 或 最 小 值 ， 可 以 使 用 summarizing 
(Int|Long|Double) 方法 中 的 某 一 个 。 这 些 方法 会 接受 一 个 将 流 对 象 映 射 为 数据 的 函数 ， 
同时 ， 这 些 方法 会 产生 类 型 为 (Int|Long|Double)SummaryStatistics 的 结果 ， 同 时 计 
算 总 和 、 数 量 、 平 均值 、 最 小 值 和 最 大 值 。 


IntSummaryStatistics summary = stream.collect( 
Collectors. summarizingInt (String: :length)) ; 
double averageWordLength = summary.getAverage() ; 

double maxWordLength = summary.getMax(); 





e Iterator<T> iterator() 
产生 一 个 用 于 获取 当前 流 中 各 个 元 素 的 迭代 器 。 这 是 一 种 终结 操作 。 
程序 清单 1-4 中 的 示例 程序 展示 了 如 何 从 流 中 收集 元 素 。 





a Ra 





1 package collecting; 
2 
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import java.10.*; 
import java.nio.charset.*; 
import java.nio. file.*; 


import java.util.stream.*; 


3 
4 
5 
6 import java.util.*; 
7 
8 


9 public class CollectingResults 


10 { 


public static Stream<String> noVowels() throws IOException 
{ 

String contents = new String(Files.readAl IBytes( 
Paths.get("../gutenberg/alice30.txt")), 
StandardCharsets .UTF_8) ; 

List<String> wordlist = Arrays.asList(contents.split("\\PL+")) ; 

Stream<String> words = wordList.stream() ; 

return words.map(s -> s.replaceAll("[aeiouAEIOU]", "")); 


} 


public static <T> void show(String label, Set<T> set) 
{ 
System.out.print(label + ": " + Set,getClass().getName()); 
System.out.printin("[" 
+ set.stream().]imit(10) .map(Object: : toString) 


.collect(Collectors.joining(", ")) + "]"); 
} 


public static void main(String[] args) throws IOException 
{ 
Iterator<Integer> iter = Stream.iterate(0, n -> n + 1).]imt(10) 
,1terator()， 
while (iter. hasNext()) 
System. out.print]n(iter.next()) ; 


0bject[] numbers = Stream.iterate(0, n -> n + 1).]imt(10).toArray(); 
System.out.printin("Object array:" + numbers); // Note it's an Object(] array 


try 

{ 
Integer number = (Integer) numbers[0]; // OK 
System.out.printIn("number: " + number); 
System.out.printIn("The following statement throws an exception:"); 
Integer{] numbers2 = (Integer[]) numbers; // Throws exception 


catch (ClassCastException ex) 


{ 


System. out. println(ex) ; 


Integer[] numbers3 = Stream.iterate(0, n -> n + 1).]imt(10) 
.toArray (Integer [] : :new) ; 
System. out.printin("Integer array: " + numbers3); // Note it's an Integer[] array 


Set<String> noVowelSet = noVowels() 
collect (Collectors. toSet()); 
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57 show("noVowelSet", noVowelSet); 

58 

59 TreeSet<String> noVowelTreeSet = noVowels().collect( 
60 Collectors. toCol lection(TreeSet: :new)); 

61 show("noVowelTreeSet", noVowelTreeSet) ; 

62 

63 String result = noVowels().limit(10).collect( 

64 Collectors. joining()); 

65 System.out.printIn("Joining: ”+ result); 

66 result = noVowels().limit(10) 

67 .collect(Collectors.joining(", ")); 

68 System.out.printIn("Joining with commas: " + result); 
69 

70 IntSummaryStatistics summary = noVowels().collect( 

71 Collectors.summarizingInt (String: :]length)); 

72 double averageWordLength = summary.getAverage(); 

73 double maxWordLength = summary.getMax() ; 

14 System.out.printIn("Average word length: " + averageWordLength) ; 
75 System.out.printIn("Max word length: " + maxWordLength) ; 
16 System.out.printIn("forEach:") ; 

77 noVowels().]imit(10).forEach(System.out::printIn) ; 

78 } 

79 } 





e void forEach(Consumer<? super T> action) 
在 流 的 每 个 元 素 上 调用 action。 这 是 一 种 终结 操作 。 

e Object[] toArray() 

e <A> AL] toArray(IntFunction<A[ ]> generator) 
产生 一 个 对 象 数 组 ， 或 者 在 将 引用 AL]: : new 传递 给 构造 器 时 ， 返 回 一 个 A 类 型 的 数 
组 。 这 些 操作 都 是 终结 操作 。 

e <R,A> R collect(Collector<? super T,A,R> collector) 


使 用 给 定 的 收集 器 来 收集 当前 流 中 的 元 素 。Cco11ectors 类 有 用 于 多 种 收集 器 的 工厂 方法 。 








e static <T> Collector<T,?,List<T>> toList() 

e static <T> Collector<T,?,Set<T>> toSet() 
产生 一 个 将 元 素 收集 到 列表 或 集中 的 收集 器 。 

e static <T,C extends Collection<T>> Collector<T,?,C> toCollection 
(Supplier<C> collectionFactory) 
产生 一 个 将 元 素 收集 到 任意 集合 中 的 收集 器 。 可 以 传递 一 个 诸如 TreeSet : : new 的 构 
aes AA. 


e static Collector<CharSequence,?,String> joining() 
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e static Collector<CharSequence,?,String> joining(CharSequence delimiter) 

e static Collector<CharSequence,?,String> joining(CharSequence delimiter, 
CharSequence prefix, CharSequence suffix) 
产生 一 个 连接 字符 串 的 收集 器 。 分 隔 符 会 置 于 字符 串 之 间 ， 而 第 一 个 字符 串 之 前 可 以 
有 前 级 ， 最 后 一 个 字符 串 之 后 可 以 有 后 级 。 如 果 没 有 指定 ,那么 它们 都 为 空 。 

e static <T> Collector<T,?,IntSummaryStatistics> summarizingInt(ToIntFunction<? 
super T> mapper) 

estatic<T> Collector<T,?,LongSummaryStatistics> summarizingLong 
(ToLongFunction<? superT> mapper ) 

e static <T> Collector<T,?,DoubleSummaryStatistics> summarizingDouble 

(ToDoubleFunction<? super T> mapper ) 

产生 能 够 生成 (Int|Long|Double)SummaryStatistics 对 象 的 收集 器 ， 通 过 它 可 以 获 

得 将 mapper 应 用 于 每 个 元 素 后 所 产生 的 结果 的 个 数 、 总 和 、 平 均值 、 最 大 值 和 最 小 值 。 


e long getCount() 
产生 汇总 后 的 元 素 的 个 数 。 
e (int|long|double) getSum( ) 
e double getAverage( ) 
PAL BUA AIO ES OE, A TEBCA FE CARING E 0。 
e (int|long|double) getMax( ) 
e (int|long|double) getMin() 
产生 汇总 后 的 元 素 的 最 大 值 和 最 小 值 ， 或 者 在 没有 任何 元 素 时 ， 产 生 (Integer | 
Long|Double).(MAX|MIN)_VALUE, 


1.9 ”收集 到 映射 表 中 


假设 我 们 有 一 个 Stream<Person>， 并 且 想 要 将 其 元 素 收集 到 一 个 映射 表 中 ， 这 样 后 续 


就 可 以 通过 它们 的 ID 来 查找 人 员 了 。Collectors .toMap 方法 有 两 个 函数 引 元 ， 它 们 用 来 
产生 映射 表 的 键 和 值 。 例 如 ， 


Map<Integer, String> idToName = people.collect( 
Collectors.toMap(Person::getId, Person: :getName) ) ; 


在 通常 情况 下 ， 值 应 该 是 实际 的 元 素 ， 因 此 第 二 个 函数 可 以 使 用 Function.identity( )。 


Map<Integer, Person> idToPerson = people.collect( 
Collectors. toMap(Person::getId, Function.identity())); 


i 


20 Java SHR Al BARE 


如 果 有 多 个 元 素 具 有 相同 的 键 ， 那 么 就 会 存在 冲突 ， 收 集 器 将 会 抛 出 一 个 IH11egal1- 
StateException 对 象 。 可 以 通过 提供 第 3 个 函数 引 元 来 覆盖 这 种 行为 ， 该 函数 会 针对 给 定 的 
已 有 值 和 新 值 来 解决 冲突 并 确定 键 对 应 的 值 。 这 个 限 数 应 该 返回 已 有 值 、 新 值 或 它们 的 组 合 。 

在 下 面 的 代码 中 ， 我 们 构建 了 一 个 映射 表 ， 存 储 了 所 有 可 用 Locale 中 的 每 种 语言 ， 它 在 
默认 Locale 中 的 名 字 (例如 “German”) 为 键 ， 而 其 本 地 化 的 名 字 (例如 “Deutsch”) 为 值 : 


Stream<Locale> locales = Stream.of(Locale.getAvailableLocales()); 
Map<String, String> languageNames = locales.collect( 
Collectors. toMap( 
Locale: :getDisplayLanguage, 
1 -> ].getDisplayLanguage(1) , 
(existingValue, newValue) -> existingValue)); 


我 们 不 关心 同一 种 语言 是 否 可 能 会 出 现 2 K (例如 ， 德 国 和 瑞士 都 使 用 德语 )， 因 此 我 们 
只 记录 第 一 项 。 


注意 : 在 本 章 中 ， 我 们 使 用 Locale 类 作为 感 兴趣 的 数据 集 的 数据 源 。 请 参阅 第 7 章 以 了 
解 有 关 Locale 的 更 多 信息 。 


现在 ， 假 设 我 们 想 要 了 解 给 定 国家 的 所 有 语言 ， 这 样 我 们 就 需要 一 个 Map<String， 
Set<String>>。 例 如 ， “Switzerland” 的 值 是 集 [French, German, Italian]。 首 先 ， 我 们 为 每 
种 语言 都 存储 一 个 单 例 集 。 无 论 何 时 ， 只 要 找到 了 给 定 国家 的 新 语言 ， 我 们 都 会 将 已 有 集 和 
新 集 做 并 操作 。 


Map<String, Set<String>> countryLanguageSets = locales.collect( 
Collectors. toMap( 
Locale: :getDisplayCountry, 
1 -> Collections.singleton(].getDisplayLanguage()) , 
(a, b) -> 
{ // Union of a and b 
Set<String> union = new HashSet<>(a) ; 
union. addAl] (b) ; 
return union; 


D); 
在 下 一 节 中 ， 你 将 会 看 到 一 种 更 简单 的 用 于 获取 这 种 映射 表 的 方式 。 
如 果 想 要 得 到 TreeMap ， 那 么 可 以 将 构造 器 作为 第 4 个 引 元 来 提供 。 你 必须 提供 一 种 合 
并 困 数 。 下 面 是 本 节 一 开始 所 列举 的 示例 之 一 ， 现 在 它 会 产生 一 个 TreeMap: 


Map<Integer, Person> idToPerson = people.col lect( 
Collectors. toMap( , 
Person: :getId, 
Function.identity(), 
(existingValue, newValue) -> { throw new Il legalStateException(); }, 
TreeMap: :new)); 


注意 : 对 于 每 一 个 toMap 方法 ， 都 有 一 个 等 价 的 可 以 产生 并 发 映射 表 的 toConcurrentMap 
方法 。 单 个 并 发 映射 表 可 以 用 于 并 行 集合 处 理 。 当 使 用 并 行 流 时 ， 共 享 的 映射 表 比 合并 映射 
表 要 更 高 效 。 注 意 ， 元 素 不 再 是 按照 流 中 的 顺序 收集 的 ， 但 是 通常 这 不 会 有 什么 问题 。 
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程序 清单 1-5 中 的 示例 程序 给 出 了 将 流 的 结果 收集 到 映射 表 中 的 示例 。 


nd, oat Ses 
i BEA he 





ı package collecting; 

2 

3 import java.10.*; 

4 import java.util.*; 

s import java.util. function. *; 

6 import java.util.stream.*; 

7 

8 public class CollectingIntoMaps 

9 

10 public static class Person 

11 { 

12 private int id; 

13 private String name; 

14 

15 public Person(int id, String name) 

16 { 

17 this.id = id; 

18 this.name = name; 

19 } 

20 

21 public int getId() 

22 { 

23 return id; 

24 } 

25 

26 public String getName () 

27 

28 return name; 

29 } 

30 

31 public String toString() 

31 

33 return getClass().getName() + "[id=" + id + ",name=" + name + "]"; 
34 } 

35 } 

36 

37 public static Stream<Person> people() 

38 { 

39 return Stream.of(new Person(1001, "Peter"), new Person(1002, "Paul"), 
40 new Person(1003, “Mary")); 

41 } 

42 

a public static void main(String[] args) throws IOException 
44 { 

45 Map<Integer, String> idToName = people().collect( 

46 Collectors.toMap(Person::getId, Person: :getName)) ; 
47 System.out.print]n("idToName: ”+ idToName) ; 

48 

49 Map<Integer, Person> idToPerson = people().collect( 

50 Collectors. toMap(Person::getId, Function.identity())); 
51 System.out.print]n("idToPerson: " + idToPerson.getClass() .getName () 
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52 + idToPerson) ; 

53 

54 idToPerson = people().collect( 

55 Collectors.toMap(Person::getId, Function.identityQ, ( 

56 existingValue, newValue) -> { 

57 throw new I] legalStateException(); 

58 }, TreeMap: :new) ) ; 

59 System.out.printIn("idToPerson: " + idToPerson.getClass() .getName() 
60 + idToPerson) ; 

61 

62 Stream<Locale> locales = Stream.of(Locale.getAvailableLocales()); 
63 Map<String, String> languageNames = locales.collect( 

64 Collectors. toMap( 

65 Locale: :getDisplayLanguage, 

66 1 -> 1.getDisplayLanguage(1) , 

67 (existingValue, newValue) -> existingValue)); 

68 System. out.print]n("languageNames: " + languageNames) ; 

69 

70 locales = Stream.of(Locale.getAvailableLocales()); 

71 Map<String, Set<String>> countryLanguageSets = locales.collect( 
n Collectors. toMap( 

73 Locale: :getDisplayCountry, 

74 ] -> Collections.singleton(].getDisplayLanguage()) , 

75 (a, b) -> { // union of a and b 

76 Set<String> union = new HashSet<>(a); 

77 union.addAl]1 (b); 

78 return union; 

79 })); 

80 System.out.print]n("countryLanguageSets: " + countryLanguageSets) ; 
81 

82 } 


estatic<T,K,U> Collector<T,?,Map<K,U>> toMap(Function<? superT,? 


extendsK> keyMapper, Function<? super T,? extends U> valueMapper ) 

estatic<T,K,U> Collector<T,?,Map<K,U>> toMap(Function<? superT,? 
extendsK> keyMapper, Function<? super T,? extends U> valueMapper, 
BinaryOperator<U> mergeFunction) 

e static <T,K,U,M extends Map<kK,U>> Collector<T,?,M> toMap(Function<? 
super T,? extends K> keyMapper, Function<? super T,? extends U> 
valueMapper, BinaryOperator<U> mergeFunction, Supplier<M> mapSupplier ) 

e static <T,K,U> Collector<T,?,ConcurrentMap<K,U>> toConcurrentMap 
(Function<? super T,? extends K> keyMapper, Function<? super T,? 
extends U> valueMapper ) 

èe static <T,K,U> Collector<T,?,ConcurrentMap<K,U>> toConcurrentMap 


(Function<? super T,? extends K> keyMapper, Function<? super T,? 
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extends U> valueMapper, BinaryOperator<U> mergeFunction) 

estatic <T,K,U,M extends ConcurrentMap<K,U>> Collector<T,?,M> 
toConcurrentMap(Function<? super T,? extends K> keyMapper, 
Function<? super T,? extends U> valueMapper, BinaryOperator<U> 
mergeFunction, Supplier<M> mapSupplier) 
产生 一 个 收集 器 ， 它 会 产生 一 个 映射 表 或 并 发 映射 表 。keyMapper 和 valueMapper PA ZL 
会 应 用 于 每 个 收集 到 的 元 素 上 ， 从 而 在 所 产生 的 映射 表 中 生成 一 个 键 / 值 项 。 默 认 情 况 
下 ， 当 两 个 元 素 产 生 相同 的 键 时 ， 会 抛 出 一 个 111egalStateException 异常 。 你 可 以 提 
供 一 个 mergeFunction 来 合并 具有 相同 键 的 值 。 默 认 情 况 下 ， 其 结果 是 一 个 HashMap 或 
ConcurrentHashMap。 你 可 以 提供 一 个 mapSupp1ier ， 它 会 产生 所 期 望 的 映射 表 实 例 。 


1.10” 群 组 和 分 区 


在 上 一 节 中 ， 你 看 到 了 如 何 收集 给 定 国家 的 所 有 语言 ， 但 是 其 处 理 显 得 有 些 了 见长 。 你 必 
须 为 每 个 映射 表 的 值 都 生成 单 例 集 ， 然 后 指定 如 何 将 现 有 集 与 新 集合 并 。 将 具有 相同 特性 的 
值 群 聚 成 组 是 非常 常见 的 ， 并 且 groupingBy 方法 直接 就 文 持 它 。 

让 我 们 来 看 看 通过 国家 来 群 组 Locale 的 问题 。 首 先 ， 构建 该 映射 表 : 


Map<String, List<Locale>> countryToLocales = locales.collect( 
Collectors. groupingBy (Locale: :getCountry)) ; 


函数 Locale: :getCountry 是 群 组 的 分 类 函数 ， 你 现在 可 以 查找 给 定 国家 代码 对 应 的 
所 有 地 点 了 ， 例 如 : 
List<Locale> swissLocales = countryToLocales.get("CH") ; 
// Yields locales [it_CH, de_CH, fr_CH] 
注意 : 快速 复习 一 下 地 点 : 每 个 Locale 都 有 一 个 语言 代码 (例如 英语 的 en) 和 一 个 国家 
代码 (例如 美国 的 US)。Locale en_US 描述 的 是 美国 英语 ,而 en IE 是 爱尔兰 英语 。 
某 些 国家 有 多 个 Locale。 例如 ，ga_IE 是 爱尔兰 的 盖 尔 语 ， 而 前 面 的 示例 也 展示 了 我 
的 JVM 知道 瑞士 有 三 个 Locale。 


当 分 类 函数 是 断言 函数 ( 即 返回 boolean 值 的 函数 ) 时 ， 流 的 元 素 可 以 分 区 为 两 个 列 
表 : 该 函数 返回 true 的 元 素 和 其 他 的 元 素 。 在 这 种 情况 下 ， 使 用 partitioningBy 比 使 用 
groupingBy 要 更 高 效 。 例 如 ， 在 下 面 的 代码 中 ， 我 们 将 所 有 Locale 分 成 了 使 用 英语 和 使 用 
所 有 其 他 语言 的 两 类 : 


Map<Boolean, List<Locale>> englishAndOtherLocales = locales.collect( 
Collectors.partitioningBy(] -> 1.getLanguage() .equals("en"))); 
List<Locale> englishLocales = englishAndOtherLocales.get (true) ; 


图 注意 : 如 果 调 用 groupingByConcurrent 方法 ， 就 会 在 使 用 并 行 流 时 获得 一 个 被 并 行 
组 装 的 并 行 映 射 表 。 这 与 toConcurrentMap 方法 完全 类 似 。 
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estatic<T,K> Collector<T,?,Map<K,List<T>>> groupingBy(Function<? 


superT,? extendsK> classifier) 
e static <T,K> Collector<T,?,ConcurrentMap<K,List<T>>> groupingByConcurrent 
(Function<? super T,? extends K> classifier) 

产生 一 个 收集 器 ， 它 会 产生 一 个 映射 表 或 并 发 映射 表 ， 其 键 是 将 classifier 应 用 于 
所 有 收集 到 的 元 素 上 所 产生 的 结果 ， 而 值 是 由 具有 相同 键 的 元 素 构 成 的 一 个 个 列表 。 
e static <T> Collector<T,?,Map<Boolean,List<T>>> partitioningBy(Predicate<? 
super T> predicate) 

产生 一 个 收集 项 ， 它 会 产生 一 个 映射 表 ， 其 键 是 true/false， 而 值 是 由 满足 /不 满足 
断言 的 元 条 构成 的 列表 。 


1.11 下 游 收集 器 


groupingBy 方法 会 产生 一 个 映射 表 ， 它 的 每 个 值 都 是 一 个 列表 。 如 果 想 要 以 某 种 方式 
来 处 理 这 些 列表 ， 就 需要 提供 一 个 “下 游 收集 器 ”。 例 如 ， 如 果 想 要 获得 集 而 不 是 列表 ， 那 
么 可 以 使 用 上 一 节 中 看 到 的 Co11ector .toSet KER. 


Map<String, Set<Locale>> countryToLocaleSet = locales.collect( 
groupingBy(Locale::getCountry, toSet())); 


注意 : 在 本 节 的 这 个 示例 以 及 后 续 示 例 中 ， 我 们 认为 静态 导入 java.util.stream. 
Collectors .* 会 使 表达 式 更 容易 阅读 。 


Java 提供 了 多 种 可 以 将 群 组 元 素 约 简 为 数字 的 收集 器 : 
e counting 会 产生 收集 到 的 元 素 的 个 数 。 例 如 : 


Map<String, Long> countryToLocaleCounts = locales.collect( 
groupingBy(Locale::getCountry, counting())); 


可 以 对 每 个 国家 有 和 多少 个 Locale 进行 计数 。 
e summing(Int|Long|Double) 会 接受 一 个 浮 数 作为 引 元 ， 将 该 函数 应 用 到 下 游 元 素 
中 ， 并 产生 它们 的 和 和。 例如: 


Map<String, Integer> stateToCityPopulation = cities.collect( 
groupingBy(City::getState, summingInt(City::getPopulation))); 


可 以 计算 城市 流 中 每 个 州 的 人 口 总 和 。 
e maxBy 和 minBy 会 接受 一 个 比较 器 ， 并 产生 下 游 元 素 中 的 最 大 值 和 最 小 值 。 例 如 . 


Map<String, Optional<City>> stateToLargestCity = cities.collect( 
groupingBy (City: :getState, 
maxBy (Comparator. comparing(City::getPopulation)))); 


可 以 产生 每 个 州 中 最 大 的 城市 。 
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mapping 方法 会 产生 将 函数 应 用 到 下 游 结 果 上 的 收集 器 ， 并 将 函数 值 传递 给 为 一 个 收集 
AF o 例如 。 


Map<String, Optional<String>> stateToLongestCityName = cities.collect( 
groupingBy (City: :getState, 
mapping(City: :getName, 
maxBy (Comparator. comparing(String::length))))); 


这 里 ， 我 们 按照 州 将 城市 群 组 在 一 起 。 在 每 个 州 内 部 ， 我 们 生成 了 各 个 城市 的 名 字 ， 并 
按照 最 大 长 度 约 简 。 

mapping 方法 还 针对 上 一 节 中 的 问题 ， 即 把 某国 所 有 的 语言 收集 到 一 个 集中 ,产生 了 一 
种 更 佳 的 解决 方案 。 


Map<String, Set<String>> countryToLanguages = locales.collect( 
groupingBy (Locale: :getDisplayCountry, 
mapping(Locale: :getDisplayLanguage, 
toSet()))); 


在 上 一 节 中 ， 我们 使 用 的 是 toMap 而 不 是 groupingBy。 而 在 上 述 这 种 方式 中 ， 我 们 无 
须 操心 如 何 将 各 个 集 组 合 起 来 。 

如 果 群 组 和 映射 函数 的 返回 值 为 int、1ong 或 double， 那么 可 以 将 元 素 收集 到 汇总 统 
计 对 象 中 ， 就 像 1.8 节 中 所 讨论 的 一 样 。 例 如 ， 


Map<String, IntSummaryStatistics> stateToCityPopulationSummary = cities.collect( 
groupingBy (City: :getState, 
summarizingInt (City: :getPopulation))) ; 


然后 ， 可 以 从 每 个 组 的 汇总 统计 对 象 中 获取 这 些 函 数值 的 总 和 、 个 数 、 平 均值 、 最 小 值 
和 最 大 值 。 


注意 ; 还 有 3 个 版 本 的 reducing 方法 ， 它 们 都 应 用 了 通用 的 约 简 操作 ， 正 如 1.12 节 中 
所 描述 的 一 样 。 


将 收集 器 组 合 起 来 是 一 种 很 强大 的 方式 ， 但 是 它 也 可 能 会 导致 产生 非常 复杂 的 表达 式 。 
它们 的 最 佳 用 法 是 与 groupingBy 和 partitioningBy 一 起 处 理 “ 下 游 的 ”映射 表 中 的 值 。 
否则 ， 应 该 直接 在 流 上 应 用 诸如 map、reduce、count、max 或 min 这 样 的 方法 。 

程序 清单 1-6 中 的 示例 程序 演示 了 下 游 收集 从 。 





package collecting; 
import static java.util.stream.Collectors.*; 
import java.nio.file.*; 


import java.util.*; 


1 

2 

3 

4 

s import java.io.*; 
6 

7 

8 import java.util.stream.*; 
9 


10 public class DownstreamCol lectors 
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public static class City 


{ 


} 


private String name; 

private String state; 

private int population; 

public City(String name, String state, int population) 
this.name = name; 
this.state = state; 
this.population = population; 

} 

public String getName () 

{ 


return name; 


} 
public String getState() 


return state; 


} 


public int getPopulation() 
{ 


} 


return population; 


public static Stream<City> readCities(String filename) throws IOException 


{ 


} 


return Files. lines(Paths.get(filename)).map(l -> 1.split(", ")) 
.Map(a -> new City(a[0], a[1], Integer.parseInt(a[2]))); 


public static void main(String[] args) throws IOException 


{ 


Stream<Locale> locales = Stream.of(Locale.getAvailableLocales()); 

locales = Stream.of(Locale.getAvailableLocales()); 

Map<String, Set<Locale>> countryToLocaleSet = locales.collect(groupingBy( 
Locale::getCountry, toSet())); 

System. out.print]n("countryToLocaleSet: " + countryToLocaleSet) ; 


locales = Stream.of(Locale.getAvailableLocales()); 

Map<String, Long> countryToLocaleCounts = locales.collect (groupingBy( 
Locale::getCountry, counting())); 

System. out.printIn("“countryToLocaleCounts: " + countryToLocaleCounts) ; 


Stream<City> cities = readCities("cities.txt"); 

Map<String, Integer> stateToCityPopulation = cities.collect(groupingBy( 
City::getState, summingInt(City::getPopulation))); 

System.out.printIn("stateToCityPopulation: " + stateToCityPopulation) ; 
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66 cities = readCities("cities. txt") ; 

67 Map<String, Optional<String>> stateToLongestCityName = cities 

68 .col lect (groupi ngBy ( 

69 City: :getState, 

70 mapping(City:: getName, 

71 maxBy (Comparator. comparing(String::length))))); 
n 

73 System.out.println("stateToLongestCityName: ”+ stateToLongestCityName) ; 
74 

75 locales = Stream.of(Locale.getAvai lableLocales()) ; 

76 Map<String, Set<String>> countryToLanguages = locales.collect(groupingBy ( 
77 Locale: :getDisplayCountry, 

78 mapping(Locale: :getDisplayLanguage, toSet()))); 

79 System.out.printIn("countryToLanguages: " + countryToLanguages) ; 

80 

81 cities = readCities("cities. txt"); 

82 Map<String, IntSummaryStatistics> stateToCityPopulationSummary = cities 
83 .col lect (groupingBy (City: :getState, 

84 summarizingInt (City: :getPopulation))) ; 

85 System. out. print]n(stateToCi tyPopul ati onSummary.get ("NY")) ; 

86 

87 cities = readCities("cities. txt") ; 

88 Map<String, String> stateToCityNames = cities.collect (groupingBy( 
89 City: :getState, 

90 reducing("", City::getName, (s, t) -> s.length() == 0?t:s 
91 #"," +t))); 

92 

93 cities = readCities("cities. txt") ; 

94 stateToCityNames = cities.collect(groupingBy (City: :getState, 

95 mapping(City::getName, joining(", ")))); 

96 System.out.println("stateToCityNames: ”+ stateToCityNames) ; 

97 } 

93 } 









e static <T> Collector<T,?,Long> counting() 
PEA — FS HY PARP AE BM TCR EFT A LR ito 

estatic <T> Collector<T,?,Integer> summingInt(ToIntFunction<? super 
T> mapper ) 

estatic <T> Collector<T,?,Long> summingLong(ToLongFunction<? super 
T> mapper) 

e static <T> Collector<T,?,Double> summingDouble(ToDoubleFunction<? 
super T> mapper) 
产生 一 个 收集 器 ， 对 将 mapper 应 用 到 收集 到 的 元 素 上 之 后 产生 的 值 计算 总 和 。 

e static <T> Collector<T,?,Optional<T>> maxBy(Comparator<? super T> 


comparator ) 
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e static <T> Collector<T,?,Optional<T>> minBy(Comparator<? super T> 
comparator) 
产生 一 个 收集 器 ， 使 用 comparator 指定 的 排序 方法 ， 计 算 收 集 到 的 元 素 中 的 最 大 值 
和 最 小 值 。 

estatic <T,U,A,R> Collector<T,?,R> mapping(Function<? super T,? 
extends U> mapper, Collector<? super U,A,R> downstream) 
PPE — SWS ae, E37" A — 7S BR Re, CEO mapper 应 用 到 收集 到 的 数据 上 而 
产生 的 ， 其 值 是 使 用 downstream 收集 器 收集 到 的 具有 相同 键 的 元 素 。 


1.12 约 简 操作 


reduce 方法 是 一 种 用 于 从 流 中 计算 某 个 值 的 通用 机 制 ， 其 最 简单 的 形式 将 接受 一 个 二 元 函 
数 ， 并 从 前 两 个 元 素 开始 持续 应 用 它 。 如 果 该 函数 是 求 和 函数 ， 那 么 就 很 容易 解释 这 种 机 制 : 


List<Integer> values = 
Optional<Integer> sum = ‘values. Stream().reduce((x, y) -> x + y); 


在 上 面 的 情况 中 , reduce 方法 会 计算 vo+vi+vz+…， 其 中 vi 是 流 中 的 元 素 。 如 果 流 为 空 
那么 该 方法 会 返回 一 个 0ptional1 ， 因 为 没有 任何 有 效 的 结果 。 


注意 : 在 上 面 的 情况 中 ， 可 以 写成 reduce(Integer: :sum) 而 不 是 reduce((x, y) -> x+y), 


i, WR reduce 方法 有 一 项 约 简 操作 op, ALAIZA MATE v, op v, op v, op… 
其 中 我 们 将 函数 调用 op(v, View) 写作 v; OP vi,1。 这 项 操作 应 该 是 可 结合 的 ， 即 组 合 元 素 时 使 
用 的 顺序 不 应 该 成 为 问题 。 在 数学 标记 法 中 ，(x op y) op z 必须 等 于 x op (y op z). 
这 使 得 在 使 用 并 行 流 时 ， 可 以 执行 高 效 的 约 简 。 

有 很 多 种 在 实践 中 会 显得 很 有 用 的 可 结合 操作 ， 例 如 求 和 、 乘 积 、 字 符 串 连接 、 取 最 大 
值 和 最 小 值 、 求 集 的 并 与 交 等 。 减 法 是 一 个 不 可 结合 操作 的 例子 ， 例 如 ，(6-3)-2 z 6-(3-2)。 

通常 ， 会 有 一 个 么 元 值 e 使 得 e op x = x， 可 以 使 用 这 个 元 素 作 为 计算 的 起 点 。 例 如 ， 
0 是 加 法 的 么 元 值 。 然 后 ， 可 以 调用 第 2 种 形式 的 reduce: 


List<Integer> values =. . 
Integer sum = values, strean(). reduce(0, (x, y) -> x + y) 
// Computes 0+ vp + v+ mt... 


如 有 果 流 为 空 ， 则 会 返回 乏 元 值 ， 你 就 再 也 不 需要 处 理 Optional 类 了 。 

现在 ,假设 你 有 一 个 对 象 流 ， 并 且 想 要 对 某 些 属性 求 和 ， 例 如 字符 串 流 中 的 所 有 字符 串 
的 长 度 ， 那 么 你 就 不 能 使 用 简单 形式 的 reduce， 而 是 需要 (T,T)->T 这 样 的 函数 ， 即 引 元 
和 结果 的 类 型 相同 的 函数 。 但 是 在 这 种 情况 下 ， 你 有 两 种 类 型 : 流 的 元 素 具 有 String 类 型 ， 
而 些 积 结果 是 整数 。 有 一 种 形式 的 reduce 可 以 处 理 这 种 情况 。 

首先 ， 你 需要 提供 一 种 “累积 器 ”函数 (total, word) -> total + word.1length()。 
这 个 限 数 会 被 反复 调用 ， 产 生 累 积 的 总 和 。 但 是 ， 当 计算 被 并 行 化 时 ， 会 有 多 个 这 种 类 型 的 计算 ， 
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你 需要 将 它们 的 结果 合并 。 因 此 ， 你 需要 提供 第 二 个 函数 来 执行 此 处 理 。 完 整 的 调用 如 下 : 
int result = words.reduce(0, 
(total, word) -> total + word.lengthQ), 
(totall, total2) -> totall + total2); 
注意 在 实践 中 ， 你 可 能 并 不 会 频繁 地 用 到 reduce 方法 。 通 常 ， 映 射 为 数字 流 并 使 用 
其 方法 来 计算 总 和 、 最 大 值 和 最 小 值 会 更 容易 。( 我 们 将 在 1.13 节 中 讨论 数字 流 。) 在 这 
个 特定 示例 中 ， 你 可 以 调用 words .mapToInt(String::length).sum(), BA CA Ù 
及 装 箱 操 作 ， 所 以 更 简单 也 更 高 效 。 
注意 : 有 时 reduce 会 显得 并 不 够 通用 。 例 如 ， 假 设 我 们 想 要 收集 BitSet 中 的 结果 。 如 
果 收 集 操 作 是 并 行 的 ， 那 么 就 不 能 直接 将 元 素 放 到 单个 BitSet 中 ， 因 为 BitSet 对 象 不 是 
线程 安全 的 。 因 此 ， 我 们 不 能 使 用 reduce， 因 为 每 个 部 分 都 需要 以 其 自己 的 空 集 开始 ， 
并 且 reduce 只 能 让 我 们 提供 一 个 么 元 值 。 此 时 ， 应 该 使 用 co11ect， 它 会 接受 单个 引 元 : 
1. 一 个 提供 者 ， 它 会 创建 目标 类 型 的 新 实例 ， 例 如 散 列 集 的 构造 嚣 。 
2. 一 个 累积 器 ， 它 会 将 一 个 元 素 添 加 到 一 个 实例 上 ， 例 如 add 方法 。 
3. 一 个 组 合 器 ， 它 会 将 两 个 实例 合并 成 一 个 ， 例 如 addA11。 
下 面 的 代码 展示 了 collect 方法 是 如 何 操作 位 集 的 : 


BitSet result = stream.collect(BitSet::new, BitSet::set, BitSet::or); 





e Optional<T> reduce(BinaryOperator<T> accumulator ) 


eT reduce(T identity, BinaryOperator<T> accumulator ) 

e<U> U reduce(U identity, BiFunction<U,? super T,U> accumulator, 
BinaryOperator<U> combiner ) 
用 给 定 的 accumulator 函数 产生 流 中 元 素 的 累积 总 和 。 如 果 提 供 了 人 么 元 ， 那 么 第 一 个 
被 累计 的 元 素 就 是 该 么 元 。 如 果 提 供 了 组 合 器 ， 那 么 它 可 以 用 来 将 分 别 累 积 的 各 个 部 
分 整合 成 总 和 。 | 

e<R> Rcollect(Supplier<R> supplier, BiConsumer<R,? superT> 
accumulator, BiConsumer<R,R> combiner ) 
将 元 素 收 集 到 类 型 R 的 结果 中 。 在 每 个 部 分 上 ， 都 会 调用 supplier 来 提供 初始 结 采 ， 
调用 accumulator 来 交替 地 将 元 素 添加 到 结果 中 ， 并 调用 combiner 来 整合 两 个 结 采 。 


1.13 ”基本 类 型 流 
到 目前 为 止 ， 我 们 都 是 将 整数 收集 到 Stream<Integer> 中 ， 尽 管 很 明显 ， 将 每 个 整 


数 都 包装 到 包装 器 对 象 中 是 很 低 效 的 。 对 其 他 基本 类 型 来 说 ， 情 况 也 是 一 样 ， 这 些 基本 类 
型 是 . double, float, long, short, char, byte 和 boolean。 流 库 中 具有 专门 的 类 
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AY IntStream, LongStream 和 DoubleStream， 用 来 直接 存储 基本 类 型 值 ， 而 无 需 使 用 
包装 器 。 如 果 想 要 存储 short、char、byte 和 boolean， 可 以 使 用 IntStream， 而 对 于 
float， 可 以 使 用 Doub1leStream。 

为 了 创建 IntStream， 需 要 调用 IntStream.of Al Arrays.stream 方法 : 


IntStream stream = IntStream.of(1, 1, 2, 3, 5); 
Stream = Arrays.stream(values, from, to); // values is an int[] array 


与 对 象 流 一 样 ， 我 们 还 可 以 使 用 静态 的 Generate 和 iterate 方法 。 此 外 ，IntStream 
和 LongStream 有 静态 方法 range 和 rangeCclosed， 可 以 生成 步 长 为 1 的 整数 范围 . 


IntStream zeroToNinetyNine = IntStream.range(0, 100); // Upper bound is excluded 
IntStream zeroToHundred = IntStream.rangeClosed(0, 100); // Upper bound is included 


CharSequence 接口 拥有 codePoints 和 chars 方法 ， 可 以 生成 由 字符 的 Unicode 码 或 
由 UTF-16 编码 机 制 的 码 元 构成 的 IntStream。( 请 参见 第 2 章 以 了 解 其 复杂 的 细节 。) 
String sentence = "\uD835\uDD46 is the set of octonions.": 
// \uD835\uDD46 is the UTF-16 encoding of the letter O, unicode U+1D546 
IntStream codes = sentence.codePoints(); 
// The stream with hex values 10546 20 69 73 20... 
当 你 有 一 个 对 象 流 时 ， 可 以 用 mapToInt、mapToLong fil mapToDouble 将 其 转换 为 基本 类 
型 流 。 例 如 ， 如 果 你 有 一 个 字符 串 流 ， 并 想 将 其 长 度 处 理 为 整数 ， 那 么 就 可 以 在 IntStream 中 
实现 此 目的 : 


Stream<String> words =.. .} 
IntStream lengths = words.mapToInt (String: : length) ; 


为 了 将 基本 类 型 流转 换 为 对 象 流 ， 需 要 使 用 boxed 方法 : 
Stream<Integer> integers = IntStream.range(0, 100).boxed(); 


通常 ， 基 本 类 型 流 上 的 方法 与 对 象 流 上 的 方法 类 似 。 下 面 是 最 主要 的 差异 : 

o toArray 方法 会 返回 基本 类 型 数组 。 

e 产生 可 选 结 果 的 方法 会 返回 一 个 0OptionalInt、0ptionalLong 或 OptionalDouble, 
这 些 类 与 Optional 类 类 似 ， 但 是 具有 getAsInt、getAsLong 和 getAsDouble jy 
法 ， 而 不 是 get 方法 。 

e 具有 返回 总 和 、 平 均值 、 最 大 值 和 最 小 值 的 sum、average 、max 和 min 方法。 对 象 
流 没 有 定义 这 些 方法 。 

e summaryStatistics 方法 会 产生 一 个 类 型 为 IntSummaryStatistics、LongSummary- 
Statistics 或 DoubleSummaryStatistics 的 对 象 ， 它 们 可 以 同时 报告 流 的 总 和 、 
平均 值 、 最 大 值 和 最 小 值 。 


注意 : Random 类 具有 ints, longs 和 doubles 方法 ， 它 们 会 返回 由 随机 数 构 成 的 基本 类 
型 流 。 


程序 清单 1-7 给 出 了 基本 类 型 流 的 API 的 示例 。 
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package streams; 


import java.io. IOException; 

import java.nio.charset.StandardCharsets ; 
import java.nio.file.Files; 

import java.nio. file. Path; 

import java.nio. file. Paths; 

import java.util.stream.Collectors; 
import java.util.stream. IntStream; 

10 import java.util.stream. Stream; 


won nr Oo n A Ww N e 


和 一 > 
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12 public class PrimitiveTypeStreams 


3 { 

14 public static void show(String title, IntStream stream) 

15 { 

16 final int SIZE = 10; 

17 int[] firstElements = stream. limit(SIZE + 1).toArray(); 

18 System.out.print(title +": "); 

19 for (int i = 0; i < firstElements. length; i++) 

20 

21 if (i > 0) System.out.print(", "); 

22 if (i < SIZE) System. out.print(firstE]ements[i]) ; 

23 else System.out.print("...'); 

24 } 

25 System.out.printIn(); 

26 } 

27 

28 public static void main(String[] args) throws IOException 

29 { 

30 IntStream isl = IntStream.generate(() -> (int) (Math.random() * 100)); 
31 show("isl", isl); 

32 IntStream is2 = IntStream.range(5, 10); 

33 show("is2", 182); 

34 IntStream is3 = IntStream.rangeClosed(5, 10); 

35 show("is3", 153); 

36 

37 Path path = Paths.get("../gutenberg/alice30. txt") ; 

38 String contents = new String(Files.readAllBytes(path), StandardCharsets.UTF_8) ; 
39 

40 Stream<String> words = Stream.of(contents.split("\\PL+")); 
41 IntStream is4 = words.mapToInt (String: : length) ; 

42 show("is4", 184); 

43 String sentence = "\uD835\uDD46 is the set of octonions."; 
44 System. out.printIn(sentence) ; 

45 IntStream codes = sentence. codePoints() ; 

46 System. out.printIn(codes.mapToObj(c -> String. format("%X ", c)).collect( 
47 Collectors.joining())); 

48 

49 Stream<Integer> integers = IntStream.range(0, 100).boxed() ; 
50 IntStream isS = integers.mapToInt (Integer: :intValue) ; 

51 show("is5", 185); 

52 } 

53 } 
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e static IntStream range(int startInclusive, int endExclusive) 


estatic IntStream rangeClosed(int startInclusive, int endInclusive) 
产生 一 个 由 给 定 范围 内 的 整数 构成 的 IntStream, 

e static IntStream of(int... values) 
产生 一 个 由 给 定 元 素 构成 的 IntStream, 

e int[] toArray() 
产生 一 个 由 当前 流 中 的 元 素 构 成 的 数组 。 

e int sum() 

e OptionalDouble average() 

e OptionalInt max() 

e OptionalInt min() 

e IntSummaryStatistics summaryStatistics() 
产生 当前 流 中 元 素 的 总 和 、 平 均值 、 最 大 值 和 最 小 值 ， 或 者 从 中 可 以 获得 这 些 结果 的 
所 有 四 种 值 的 对 象 。 

e Stream<Integer> boxed() 


POE FAP SB Dit FAC RY Le aT ARM 





e static LongStream range(long startInclusive, long endExclusive) 


estatic LongStream rangeClosed(long startInclusive, long 
endInclusive) 
用 给 定 范围 内 的 整数 产生 一 个 LongStream。 

e static LongStream of(long... values) 
用 给 定 元 素 产生 一 个 LongStream。 

è long[] toArray() 
H Kam PIR EANA. 

e long sum() 

e OptionalDouble average() 

e OptionalLong max() 

e OptionalLong min() 

e LongSummaryStatistics summaryStatistics() 
产生 当前 流 中 元 素 的 总 和 、 平 均值 、 最 大 值 和 最 小 值 ， 或 者 从 中 可 以 获得 这 些 结果 的 
所 有 四 种 值 的 对 象 。 

e Stream<Long> boxed() 


产生 用 于 当前 流 中 的 元 素 的 包装 需 对 象 流 。 


华章 IT 
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e static DoubleStream of(double... values) 
用 给 定 元 素 产 生 一 个 DoubleStream。 

e double[] toArray() 

用 当前 流 中 的 元 素 产 生 一 个 数组 。 

edouble sum() 

e OptionalDouble average( ) 

e OptionalDouble max() 

e OptionalDouble min() 

e DoubleSummaryStatistics summaryStatistics() 
产生 当前 流 中 元 素 的 总 和 、 平 均值 、 最 大 值 和 最 小 值 ， 或 者 从 中 可 以 获得 这 些 结果 的 
所 有 四 种 值 的 对 象 。 

e Stream<Double> boxed() 


产生 用 于 当前 流 中 的 元 素 的 包装 器 对 象 流 。 


e IntStream codePoints() 8 


产生 由 当前 字符 串 的 所 有 Unicode 码 点 构成 的 流 。 


èe IntStream ints() 


e IntStream ints(int randomNumberOrigin, int randomNumberBound) 8 

e IntStream ints(long streamSize) 8 

eIntStream ints(long streamSize, int randomNumberOrigin, int 
randomNumberBound) 8 

e LongStream longs() 8 

e LongStream longs(long randomNumberOrigin, long randomNumberBound) 8 

è LongStream longs(long streamSize) 8 

eLongStream longs(long streamSize, long randomNumberOrigin, long 
randomNumberBound) 8 

e DoubleStream doubles() 8 

eDoubleStream doubles(double randomNumberOrigin, double 
randomNumberBound) 8 

e DoubleStream doubles( long streamSize) 8 

eDoubleStream doubles(long streamSize, double randomNumberOrigin, 


double randomNumberBound) 8 
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产生 随机 数 流 。 如 果 提 供 了 streamSize， 这 个 流 就 是 具有 给 定数 量 元 素 的 有 限 流 。 当 
提供 了 边界 时 ， 其 元 素 将 位 于 randomNumberorigin (包含 ) 和 randomNumberBound 
(不 包含 ) 的 区 间 内 。 





e static Optional(Int|Long|Double) of((int|long|double) value) 
用 所 提供 的 基本 类 型 值 产生 一 个 可 选 对 象 。 
e (int|long|double) getAs(Int|Long|Double)() 
产生 当前 可 选 对 象 的 值 ， 或 者 在 其 为 空 时 抛 出 一 个 NoSuchE1ementException 异常 。 
e(int|longldouble) orElse((int|long|double) other) 
e (int|long|double) orElseGet((Int|Long|Double)Supplier other) 
产生 当前 可 选 对 象 的 值 ， 或 者 在 这 个 对 象 为 空 时 产生 可 替代 的 值 。 
evoid ifPresent((Int|Long|Double)Consumer consumer ) 


如 果 当 前 可 选 对 象 不 为 空 ， 则 将 其 值 传递 给 consumer, 
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e long getCount() 

e (int|long|double) getSum( ) 

e double getAverage( ) 

e (int|long|double) getMax( ) 

e (int|long|double) getMin() 

产生 收集 到 的 元 素 的 个 数 、 总 和 、 平 均值 、 最 大 值 和 最 小 值 。 


1.14 并行 流 


流 使 得 并 行 处 理 块 操作 变 得 很 容易 。 这 个 过 程 几乎 是 自动 的 ,但 是 需要 遵守 一 些 规则 。 
首先 ， 必 须 有 一 个 并 行 流 。 可 以 用 Collection.paralle1lStream( ) 方法 从 任何 集合 中 获 
取 一 个 并 行 流 : 

Stream<String> parallelWords = words.parallelStream(); 

MAL, parallel 方法 可 以 将 任意 的 顺序 流转 换 为 并 行 流 。 

Stream<String> parallelWords = Stream.of(wordArray) .parallel (); 

只 要 在 终结 方法 执行 时 ， 流 处 于 并 行 模式 ， 那 么 所 有 的 中 间 流 操作 都 将 被 并 行 化 。 

当 流 操作 并 行 运 行 时 ， 其 目标 是 要 让 其 返回 结果 与 顺序 执行 时 返回 的 结果 相同 。 重 要 的 
是 ， 这 些 操 作 可 以 以 任意 顺序 执行 。 

下 面 的 示例 是 一 项 你 无 法 完成 的 任务 。 假 设 你 想 要 对 字符 串 流 中 的 所 有 短 单词 计数 : 
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int[] shortWords = new int[12]; 
words.parallelStream() . forEach( 
s -> { if (s.length() < 12) shortWords[s.length()]++; }); 
// Error-race condition! 
System. out.printin(Arrays.toString(shortWords)) ; 


这 是 一 种 非常 非常 糟糕 的 代码 。 传 递 给 forEach 的 函数 会 在 多 个 并 发 线程 中 运行 ， 每 个 
都 会 更 新 共享 的 数组 。 正 如 我 们 在 卷 工 第 14 章 中 所 解释 的 ， 这 是 一 种 经 典 的 竞争 情况 。 如 
果 多 次 运行 这 个 程序 ， 你 很 可 能 就 会 发 现 每 次 运行 都 会 产生 不 同 的 计数 值 ， 而 且 每 个 都 是 
错 的 。 
你 的 职责 是 要 确保 传递 给 并 行 流 操 作 的 任何 函数 都 可 以 安全 地 并 行 执行 ， 达 到 这 个 目的 
的 最 佳 方式 是 远离 易 变 状态 。 在 本 例 中 ， 如 果 用 长 度 将 字符 串 群 组 ， 然 后 分 别 对 它们 进行 计 
数 ， 那 么 就 可 以 安全 地 并 行 化 这 项 计算 。 
Map<Integer, Long> shortWordCounts = 
words.parallelStream() 
.filter(s -> s.length() < 10) 
.Collect(groupingBy( 


String: :length, 
counting())); 


O 警告 : 传递 给 并 行 流 操作 的 函数 不 应 该 被 堵塞 。 并 行 流 使 用 fork-join 池 来 操作 流 的 各 

个 部 分 。 如 果 多 个 流 操 作 被 阻塞 ， 那 么 池 可 能 就 无 法 做 任何 事情 了 。 

默认 情况 下 ， 从 有 序 集合 (数组 和 列表 )、 范 围 、 生 成 器 和 迭代 产生 的 流 ， 或 者 通过 震 用 
Stream.sorted 产生 的 流 ， 都 是 有 序 的 。 它 们 的 结果 是 按照 原来 元 素 的 顺序 累积 的 ， 因 此 
是 完全 可 预知 的 。 如 果 运 行 相同 的 操作 两 次 ， 将 会 得 到 完全 相同 的 结果 。 

排序 并 不 排斥 高 效 的 并 行 处 理 。 例 如 ， 当 计算 stream.map(fun) 时 ， 流 可 以 被 划分 为 
n 的 部 分 ， 它 们 会 被 并 行 地 处 理 。 然 后 ， 结 果 将 会 按照 顺序 重新 组 装 起 来 。 

当 放 弃 排 序 需求 时 ， 有 些 操作 可 以 被 更 有 效 地 并 行 化 。 通 过 在 流 上 调用 unordered 77 
法 ， 就 可 以 明确 表示 我 们 对 排序 不 感 兴趣 。Stream.distinct 就 是 从 这 种 方式 中 获 益 的 一 
种 操作 。 在 有 序 的 流 中 ，distinct 会 保留 所 有 相同 元 素 中 的 第 一 个 ， 这 对 并 行 化 是 一 种 阻 
碍 ， 因 为 处 理 每 个 部 分 的 线程 在 其 之 前 的 所 有 部 分 都 被 处 理 完 之 前 ， 并 不 知道 应 该 丢弃 哪些 
元 素 。 如 果 可 以 接受 保留 唯一 元 素 中 任意 一 个 的 做 法 ， 那么 所 有 部 分 就 可 以 并 行 地 处 理 (使 
用 共享 的 集 来 跟踪 重复 元 素 )。 

还 可 以 通过 放弃 排序 要 求 来 提高 1imit 方法 的 速度 。 如 果 只 想 从 流 中 取出 任意 n 个 元 
素 ， 而 并 不 在 意 到 底 要 获取 哪些 ， 那 么 可 以 调用 : 


Stream<String> sample = words.parallelStream() .unordered().limit(n); 


正如 1.9 节 所 讨论 的 ， 合 并 映射 表 的 代价 很 高 昂 。 正 是 因为 这 个 原因 ，Col11ectors . 
groupByConcurrent 方法 使 用 了 共享 的 并 发 映射 表 。 为 了 从 并 行 化 中 获 益 ， 映 射 表 中 值 的 
顺序 不 会 与 流 中 的 顺序 相同 。 


i 
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Map<Integer, List<String>> result = words.parallelStream() .collect( 
Collectors.groupingByConcurrent (String: :length)); 
// Values aren’t collected in stream order 


当然 ， 如 果 使 用 独立 于 排序 的 下 游 收 集 右 ， 那 么 就 不 必 在 意 了 ， 例 如 : 


Map<Integer, Long> wordCounts = 
words.parallelStream() 
Collect( 
groupingByConcurrent( 
String: :length, 
counting())); 


O 警告 : 不 要 修改 在 执行 某 项 流 操作 后 会 将 元 素 返回 到 流 中 的 集合 (即使 这 种 修改 是 线程 
安全 的 )。 记 住 ， 流 并 不 会 收集 它们 的 数据 ， 数 据 总 是 在 单独 的 集合 中 。 如 果 修 改 了 这 样 
的 集合 ， 那 么 流 操作 的 结果 就 是 未 定义 的 。JDK 文档 对 这 项 需求 并 未 做 出 任何 约束 ， 并 
且 对 顺序 流 和 并 行 流 都 采用 了 这 种 处 理 方 式 。 
更 准确 地 讲 ， 因 为 中 间 的 流 操作 都 是 惰性 的 ， 所 以 直到 执行 终结 操作 时 才 对 集合 进行 修 
改 仍 旧 是 可 行 的 。 例 如 ， 下 面 的 操作 尽管 并 不 推荐 ， 但 是 仍旧 可 以 工作 : 


List<String> wordlist = ，，,; 
Stream<String> words = wordList.stream() ; 
wordList.add("END") ; 

long n = words.distinct() .count(); 


但 是 ， 下 面 的 代码 是 错误 的 : 


Stream<String> words = wordList.stream() ; 
words. forEach(s -> if (s.length() < 12) wordList.remove(s)); 
// Error-interference 


为 了 让 并 行 流 正常 工作 ， 需 要 满足 大 量 的 条 件 : 
o 数据 应 该 在 内 存 中 。 必 须 等 到 数据 到 达 是 非常 低 效 的 。 
© 流 应 该 可 以 被 高 效 地 分 成 若干 个 子 部 分 。 由 数组 或 平衡 二 叉 树 支撑 的 流 都 可 以 工作 得 
很 好 ， 但 是 Stream.iterate 返回 的 结果 不 行 。 
e 流 操作 的 工作 量 应 该 具有 较 大 的 规模 。 如 果 总 工作 负载 并 不 是 很 大 ， 那 么 搭建 并 行 计 
算 时 所 付出 的 代价 就 没有 什么 意义 。 
© 流 操作 不 应 该 被 阻塞 。 
换 句 话说 ,不 要 将 所 有 的 流 都 转换 为 并 行 流 。 只 有 在 对 已 经 位 于 内 存 中 的 数据 执行 大 量 
计算 操作 时 ， 才 应 该 使 用 并 行 流 。 
程序 清单 1-8 中 的 示例 程序 展示 了 如 何 操作 并 行 流 。 





package parallel; 


import static java.util.stream.Collectors.*; 
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5 import java.10.*; 

6 import java.nio.charset.*; 
7 import java.nio.file.*: 

8 import java.util.*; 

9 import java.util.stream.*; 


11 public class ParallelStreams 


2 { 

3 public static void main(String[] args) throws IOException 

14 { 

15 String contents = new String(Files. readAllBytes( 

16 Paths.get("../gutenberg/alice30.txt")), StandardCharsets .UTF_8) ; 
17 List<String> wordlist = Arrays.asList(contents.split("\\PL+")); 
18 

19 // Very bad code ahead 

20 int[] shortWords = new int[10] ; 

21 wordList.parallelStream().forEach(s -> 

22 { 

23 if (s.length() < 10) shortWords[s.length()]++; 

24 1} 

25 System.out.printIn(Arrays.toString(shortWords)) ; 

26 

27 // Try again--the result will likely be different (and also wrong) 
28 Arrays. fill(shortWords, 0); 

29 wordList.parallelStream().forEach(s -> 

30 { 

31 if (s.length() < 10) shortWords[s.length()]++; 

32 让 

33 System. out.printin(Arrays.toString(shortWords)) ; 

34 

35 // Remedy: Group and count 

36 Map<Integer, Long> shortWordCounts = wordList.parallelStream() 
37 .filter(s -> s.length() < 10) 

38 .collect(groupingBy(String::length, counting())); 

39 

40 System,out.printin(shortWordCounts) ; 

41 

42 // Downstream order not deterministic 

43 Map<Integer, List<String>> result = wordList.parallelStream() .collect( 
44 Collectors.groupingByConcurrent (String: :length)) ; 

45 

46 System. out.println(result.get(14)); 

47 

48 result = wordList.parallelStream() .collect( 

49 Collectors. groupingByConcurrent (String: : length)) ; 

50 

51 System.out.printIn(result.get(14)); 

52 

53 Map<Integer, Long> wordCounts = wordList.parallelStream().collect( 
54 groupingByConcurrent(String:: length, counting())); 

55 

56 System.out.printIn(wordCounts) ; 

57 } 

58} 
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eS parallel() 
产生 一 个 与 当前 流 中 元 素 相同 的 并 行 流 。 
eS unordered( ) 


产生 一 个 与 当前 流 中 元 素 相 同 的 无 序 流 。 





e Stream<E> parallelStream() 8 
用 当前 集合 中 的 元 素 产 生 一 个 并 行 流 。 
在 本 章 中 ， 你 学 习 到 了 如 何 运用 Java 8 的 流 库 。 下 一 章 将 讨论 另 一 个 重要 的 主题 : 处 理 


输入 和 输出 。 





第 2 章 输入 与 输出 


A 输入 /输出 流 A 操作 文件 
A 文本 输入 与 输出 A 内 存 映射 文件 
A 读 写 二 进 制 数据 A 正则 表达 式 


A 对 象 输入 /输出 流 与 序列 化 


本 章 将 介绍 Java 中 用 于 输入 和 输出 的 各 种 应 用 编程 接口 ( Application Programming 
Iterface，API) 。 你 将 要 学 习 如 何 访问 文件 与 目录 ， 以 及 如 何以 二 进 制 格式 和 文本 格式 来 读 
写 数 据 。 本 章 还 要 向 你 展示 对 象 序列 化 机 制 ， 它 可 以 使 存储 对 象 像 存储 文本 和 数值 数据 一 样 
容易 。 然 后 ， 我 们 将 介绍 使 用 文件 和 目录 。 最 后 ， 本 章 将 讨论 正则 表达 式 ， 尽 管 这 部 分 内 容 
实际 上 与 输入 和 输出 并 不 相关 ， 但 是 我 们 确实 也 找 不 到 更 合适 的 地 方 来 处 理 这 个 话题 。 很 明 
显 ，Java 设计 团队 在 这 个 问题 的 处 理 上 和 我 们 一 样 ， 因 为 正则 表达 式 API 的 规格 说 明 素 属于 
“新 UO” 特 性 的 规格 说 明 。 


2.1 输入 /输出 沅 


在 Java API 中 ,可 以 从 其 中 读 入 一 个 字 节 序列 的 对 象 称 做 输入 流 ， 而 可 以 向 其 中 写 人 一 
个 字 节 序列 的 对 象 称 做 输出 流 。 这 些 字 节 序列 的 来 源 地 和 目的 地 可 以 是 文件 ， 而 且 通 常 都 是 
文件 , 但 是 也 可 以 是 网 络 连 接 ， 其 至 是 内 存 块 。 抽 象 类 InputStream 和 OutputStream 构 
成 了 输入 /输出 (IO) 类 层次 结构 的 基础 。 
注意 : 这 些 输 入 /输出 流 与 在 前 一 章 中 看 到 的 流 没 有 任何 关系 。 为 了 清楚 起 见 ， 只 要 是 

讨论 用 于 输入 和 输出 的 流 ， 我 们 都 将 使 用 术语 输入 流 、 输 出 流 或 输入 /输出 流 。 

因为 面向 字 节 的 流 不 便于 处 理 以 Unicode 形式 存储 的 信息 (回忆 一 下 ，Unicode 中 每 个 
字符 都 使 用 了 多 个 字 节 来 表示 )， 所 以 从 抽象 类 Reader 和 Writer 中 继承 出 来 了 一 个 专门 用 
于 处 理 Unicode 字符 的 单独 的 类 层次 结构 。 这 些 类 拥有 的 读 入 和 写 出 操作 都 是 基于 两 字 太 的 
Char (HW) (BN, Unicode 码 元 )， 而 不 是 基于 byte 值 的 。 


2.1.1 读 写 字 节 
InputStream 类 有 一 个 抽象 方法 : 


abstract int read() 


这 个 方法 将 读 入 一 个 字 节 ， 并 返回 读 和 人 的 字 节 ， 或 者 在 遇 到 输入 源 结尾 时 返回 -1。 在 设 
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计 具 体 的 输入 流 类 时 ， 必 须 履 盖 这 个 方法 以 提供 适用 的 功能 ， 例 如 ， 在 FileInputStream 

类 中 ， 这 个 方法 将 从 某 个 文件 中 读 入 一 个 字 节 ， 而 System.in ( 它 是 InputStream 的 一 个 

子 类 的 预定 义 对 象 ) 却 是 从 “标准 输入 ”中 读 和 信息 ， 即 控制 台 或 重 定向 的 文件 。 
InputStream 类 还 有 硅 干 个 非 抽 象 的 方法 ,它们 可 以 读 人 一 个 字 节 数组 ， 或 者 跳 过 大 量 

的 字 节 。 这 些 方法 都 要 调用 抽象 的 read 方法 ， 因 此 ， 各 个 子 类 都 只 需 覆 盖 这 一 个 方法 。 
与 此 类 似 ，0utputStream 类 定义 了 下 面 的 抽象 方法 : 


abstract void write(int b) 


它 可 以 向 某 个 答 出 位 置 写 出 一 个 字 节 。 

read 和 write 方法 在 执行 时 都 将 阻塞 ， 直 至 字 节 确 实 被 读 和 人 或 写 出 。 这 就 意味 着 如 果 
流 不 能 被 立即 访问 (通常 是 因为 网 络 连 接 忙 )， 那 么 当前 的 线程 将 被 阻塞。 这 使 得 在 这 两 个 方 
法 等 竺 指定 的 流 变 为 可 用 的 这 段 时 间 里 ， 其 他 的 线程 就 有 机 会 去 执行 有 用 的 工作 。 

available 方法 使 我 们 可 以 去 检查 当前 可 读 人 的 字 节 数量 ， 这 意味 着 像 下 面 这 样 的 代码 
片段 就 不 可 能 被 阻塞 : 

int bytesAvailable = in.available(); 

if (bytesAvailable > 0) 


byte[] data = new byte[bytesAvai lable]; 
in. read (data) ; 


当 你 完成 对 输入 /输出 流 的 读 写 时 ， 应 该 通过 调用 close 方法 来 关闭 它 ， 这 个 调用 会 释 
放 掉 十 分 有 限 的 操作 系统 资源 。 如 果 一 个 应 用 程序 打开 了 过 多 的 输入 /输出 流 而 没有 关闭 ， 
那么 系统 资源 将 被 耗 尽 。 关 闭 一 个 输出 流 的 同时 还 会 冲刷 用 于 该 输出 流 的 缓冲 区 : 所 有 被 临 
时 和 置 于 缓冲 区 中 ， 以 便 用 更 大 的 包 的 形式 传递 的 字 节 在 关闭 输出 流 时 都 将 被 送出 。 特 别 是 ， 
如 果 不 关 闭 文件 ， 那 么 写 出 字 节 的 最 后 一 个 包 可 能 将 永远 也 得 不 到 传递 。 当 然 ， 我 们 还 可 以 
用 flush 方法 来 人 为 地 冲刷 这 些 输 出 。 

即使 某 个 输入 /输出 流 类 提供 了 使 用 原生 的 read 和 write 功能 的 某 些 具体 方法 ， 应 用 
系统 的 程序 员 还 是 很 少 使 用 它们 ， 因 为 大 家 感 兴 趣 的 数据 可 能 包含 数字 、 字 符 串 和 对 象 ， 而 
不 是 原生 字 节 。 

我 们 可 以 使 用 众多 的 从 基本 的 InputStream 和 OutputStream 类 导出 的 某 个 输入 / 输 
出 类 ， 而 不 只 是 直接 使 用 字 节 。 





Be roa 


e abstract int read() 
从 数据 中 读 人 一 个 字 节 ， 并 返回 该 字 节 。 这 个 read 方法 在 碰 到 输入 流 的 结尾 时 返回 -1 
e int read(byte[] b) 
谈 人 一 个 字 节 数组 ， 并 返回 实际 读 人 的 字 节 数 ， 或 者 在 碰 到 输入 流 的 结尾 时 返回 -1。 
这 个 read 方法 最 多 读 人 bb.1ength 个 字 节 。 
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e int read(byte[] b, int off, int len) 
读 入 一 个 字 节 数组 。 这 个 read 方法 返回 实际 读 人 的 字 节 数 ， 或 者 在 碰 到 输入 流 的 结尾 
时 返回 -1。 
参数 : b 数据 读 入 的 数组 
off 第 一 个 读 入 字 节 应 该 被 放置 的 位 置 在 b 中 的 偶 移 量 
len 读 入 字 节 的 最 大 数量 
e long skip(long n) 
在 输入 流 中 跳 过 nm 个 字 节 ， 返 回 实际 跳 过 的 字 节 数 (如 果 碰 到 输入 流 的 结尾 ， 则 可 能 
NF nho 
e int available() 
返回 在 不 阻塞 的 情况 下 可 获取 的 字 节 数 (回忆 一 下 ， 阻 塞 意味 着 当前 线程 将 失去 它 对 
资源 的 占用 )。 
e void close() 
关闭 这 个 输入 流 。 
e void mark(int readlimit) 
在 输入 流 的 当前 位 置 打 一 个 标记 (并非 所 有 的 流 都 支持 这 个 特性 )。 如 果 从 输入 流 中 已 
经 读 入 的 字 节 多 于 read1imit 个 ， 则 这 个 流 允许 忽略 这 个 标记 。 
evoid reset() 
返回 到 最 后 一 个 标记 ， 随 后 对 read 的 调用 将 重新 读 入 这 些 字 节 。 如 果 当 前 没有 任何 标 
记 ， 则 这 个 流 不 被 重 置 。 
e boolean markSupported( ) 


如 果 这 个 流 支 持 打 标记 ， 则 返回 true, 





e abstract void write(Cint n) 
写 出 一 个 字 节 的 数据 。 
e void write(byte[] b) 
e void write(byte[] b, int off, int len) 
写 出 所 有 字 节 或 者 某 个 范围 的 字 节 到 数组 b 中 。 
参数 : b 数据 写 出 的 数组 
off 第 一 个 写 出 字 节 在 b FERNE E 
len 写 出 字 节 的 最 大 数量 
e void close() 
冲刷 并 关闭 输出 流 。 
e void flush() 
冲刷 输出 流 ， 也 就 是 将 所 有 缓冲 的 数据 发 送 到 目的 地 。 


: IESIT 


42 Java ZSRR AI BAHH 


2.1.2 完整 的 流 家 族 


与 C 语言 只 有 单一 类 型 FILE* 包 打 天 下 不 同 ，Java 拥有 一 个 流 家 族 ， 包 含 各 种 输入 / 输 
出 流 类 型 ， 其 数量 超过 60 个 ! 请 参见 图 2-1 和 图 2-2。 
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图 2-1 输入 流 与 输出 流 的 层次 结构 


让 我 们 把 输入 /输出 流 家 族 中 的 成 员 按 照 它 们 的 使 用 方法 来 进行 划分 ， 这样 就 形成 了 处 
理 字 节 和 字符 的 两 个 单独 的 层次 结构 。 正 如 所 见 ，InputStream #l OutputStream 类 可 以 
读 写 单个 字 节 或 字 节 数组 ， 这 些 类 构成 了 图 2-1 所 示 的 层次 结构 的 基础 。 要 想 读 写字 符 串 和 
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数字 ， 就 需要 功能 更 强大 的 子 类 ， 例 如 ，DataInputStream fl DataOutputStream 可 以 以 
二 进 制 格式 读 写 所 有 的 基本 Java 类 型 。 最 后 ， 还 包含 了 多 个 很 有 用 的 输入 /输出 流 ， 例 如 ， 
ZipInputStream 和 ZipoutputStream AJ LAVA is ULAJ ZIP 压缩 格式 读 写 文件 。 

另 一 方面 ， 对 于 Unicode 文本 ， 可 以 使 用 抽象 类 Reader 和 Writer 的 子 类 (请 参见 图 2-2 )。 
Reader fil Writer 类 的 基本 方法 与 InputStream fil OutputStream 中 的 方法 类 似 。 


abstract int read() 
abstract void write(int c) 


read 方法 将 返回 一 个 Unicode 码 元 (一 个 在 0 ~ 65535 之 间 的 整数 )， 或 者 在 碰 到 文件 
结尾 时 返回 -1。write 方 法 在 被 调用 时 ， 需 要 传递 一 个 Unicode 码 元 (请 查看 卷 1 第 3 A 
Æ Unicode 码 元 的 讨论 )。 





图 2-2 Reader 和 Writer 的 层次 结构 


if 


44 Java SRR All AAHH 


还 有 4 个 附加 的 接口 : Closeable, Flushable, Readable fil Appendable (请 查看 
图 2-3 )。 前 两 个 接口 非常 简单 ， 它 们 分 别 拥 有 下 面 的 方法 : 
void close() throws IOException 
和 
void flush() 
InputStream, OutputStream, Reader 和 Writer 都 实现 了 Closeable 接口 。 
注意 : java.io.Closeable 接口 扩展 了 java.lang.AutoCloseable 接口 。 因 此 ， 对 任何 
Closeable 进行 操作 时 ， 都 可 以 使 用 try-with-resource 7% 4) ( try-with-resource 语句 是 指 声 
明了 一 个 或 多 个 资源 的 try 语句 译 者 注 )。 为 什么 要 有 两 个 接口 呢 ? 因为 Closeable 接 
口 的 close 方法 只 抛 出 IOException， 而 AutoCloseable.close 方法 可 以 抛 出 任何 异常 。 
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图 2-3 Closeable, Flushable. Readable 和 Appendable 接口 


而 OutputStream 和 Writer 还 实现 了 Flushable 接口 。 

Readable 接口 只 有 一 个 方法 : 

int read(CharBuffer cb) 

CharBuffer 类 拥有 按 顺序 和 随机 地 进行 读 写 访问 的 方法 ， 它 表示 一 个 内 存 中 的 缓冲 区 
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或 者 一 个 内 存 映像 的 文件 〈 请 参见 2.6.2 市 以 了 解 细 市)。 
Appendable 接口 有 两 个 用 于 添加 单个 字符 和 字符 序列 的 方法 : 


Appendable append(char c) 
Appendable append(CharSequence s) 


CharSequence 接口 描述 了 一 个 char 值 序 列 的 基本 属性 ，String、CharBuffer、 
StringBuilder 和 StringBuffer 都 实现 了 它 。 
在 流 类 的 家 族 中 ， 只 有 Writer 实现 了 Appendab1e。 





e void close() 


关闭 这 个 Cl1oseable， 这 个 方法 可 能 会 抛 出 IO0Exception。 





s A 


e void flush() 
冲刷 这 个 Flushable。 






e int read(CharBuffer cb) 
尝试 着 向 cb 读 入 其 可 持 有 数量 的 char 值 。 返 回 读 人 的 char 值 的 数量 ， 或 者 当 从 这 
个 Readable 中 无 法 再 获得 更 多 的 值 时 返回 -1。 


RR AA a daor Arai priate 
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e Appendable append(char c) 
e Appendable append(CharSequence cs) 
向 这 个 Appendable 中 追加 给 定 的 码 元 或 者 给 定 的 序列 中 的 所 有 人 码 元 ， 返 回 this. 





echar charAt(int index) 


返回 给 定 索 引 处 的 码 元 。 


eint length() 
返回 在 这 个 序列 中 的 码 元 的 数量 。 
e CharSequence subSequence(int startIndex, int endIndex ) 


返回 由 存储 在 startIndex 到 endIndex-1 处 的 所 有 码 元 构成 的 CharSequence, 
e String toString() 


返回 这 个 序列 中 所 有 码 元 构成 的 字符 串 。 


2.1.3 ”组合 输 入 / 输出 流 过 滤器 
FileInputStream All FileOutputStream 可 以 提供 附着 在 一 个 磁盘 文件 上 的 输入 流 和 
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WEA, MERR m RHE Ar et FARF EREA o AAN: 
FileInputStream fin = new FileInputStream("employee.dat") ; 


这 行 代码 可 以 查看 在 用 户 目录 下 名 为 “emp1oyee.dat” 的 文件 。 


O 提示 : TA java.io 中 的 类 都 将 相对 路 径 名 解释 为 以 用 户 工作 目录 开始 ， 你 可 以 通过 
调用 System.getProperty("user .dir") 来 获得 这 个 信息 。 


O 警告 : 由 于 反 针 杠 字符 在 Java 字符 串 中 是 转 义 字符 ， 因 此 要 确保 在 Windows 风格 的 路 
径 名 中 使 用 (例如 ，C:NWindowsNwin.ini)。 在 Windows 中 ， 还 可 以 使 用 单 斜 杠 字符 
(C:/Windows/win.ini)， 因 为 大 部 分 Windows 文件 处 理 的 系统 调用 都 会 将 斜 杠 解释 成 文件 
分 隔 符 。 但 是 ， 并 不 推荐 这 样 做 ， 因 为 Windows 系统 函数 的 行为 会 因 与 时 俱 进 而 发 生变 
化 。 因 此 ， 对 于 可 移植 的 程序 来 说 ， 应 该 使 用 程序 所 运行 平台 的 文件 分 隔 符 ， 我 们 可 以 
通过 常量 字符 串 java.io.File.separator 获得 它 。 


与 抽象 类 InputStream 和 OutputStream 一 样 ， 这 些 类 只 文 持 在 字 节 级 别 上 的 读 写 。 
也 就 是 说 ， 我 们 只 能 从 Fin 对 象 中 读 入 字 节 和 字 节 数组 。 

byte b = (byte) fin.read(); 

正如 下 市 中 看 到 的 ， 如 果 我 们 只 有 DataInputStream， 那 么 我 们 就 只 能 读 人 数值 类 型 . 


DataInputStream din = ，， 
double x = din. O. 


但 是 正如 FileInput Stream 没有 任何 读 人 数值 类 型 的 方法 一 样 ，DataInputStream 
也 没有 任何 从 文件 中 获取 数据 的 方法 。 

Java 使 用 了 一 种 灵巧 的 机 制 来 分 离 这 两 种 职责 。 某 些 输入 流 (例如 FileInputStream 
和 由 URL 类 的 openStream 方 法 返回 的 输入 流 ) 可 以 从 文件 和 其 他 更 外 部 的 位 置 上 获取 
字 市 ， 而 其 他 的 输入 流 (例如 DataInputsStream) 可 以 将 字 节 组 装 到 更 有 用 的 数据 类 型 
中 。Java 程序 员 必 须 对 二 者 进行 组 合 。 例 如 ， 为 了 从 文件 中 读 入 数字 ， 首 先 需 要 创建 一 个 
FileInputStream， 然 后 将 其 传递 给 DataInputStream 的 构造 器 : 


FileInputStream fin = new FileInputStream("employee.dat") ; 
DataInputStream din = new DataInputStream(fin) ; 
double x = din. readDouble(); 


如 果 再 次 查看 图 2-1， 你 就 会 看 到 FilterInputStream fl FilterOutputStream 类， 
这 些 文件 的 子 类 用 于 同 处 理 字 节 的 输入 /输出 流 添 加 额外 的 功能 。 

你 可 以 通过 座 套 过 滤 需 来 添加 多 重 功能 。 例 如 ， 输 入 流 在 默认 情况 下 是 不 被 缓冲 区 缓存 
的 ， 也 就 是 说 ， 每 个 对 read 的 调用 都 会 请 求 操作 系统 再 分 发 一 个 字 节 。 相 比 之 下 ， 请 求 一 
个 数据 块 并 将 其 置 于 缓冲 区 中 会 显得 更 加 高 效 。 如 果 我 们 想 使 用 缓冲 机 制 ， 以 及 用 于 文件 的 
数据 输入 方法 ， 那 么 就 需要 使 用 下 面 这 种 相当 钨 怖 的 构造 器 序列 : 


DataInputStream din = new DataInputStream( 
new BufferedInputStream( 
new FileInputStream("employee.dat"))); 
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注意 ， 我 们 把 DataInputStream 置 于 构造 器 链 的 最 后 ， 这 是 因为 我 们 希望 使 用 
DataInputStream 的 方法 ， 并 且 希 望 它 们 能 够 使 用 带 缓冲 机 制 的 read 方法 。 

有 了 时 当 多 个 输入 流 链接 在 一 起 时 ， 你 需要 跟踪 各 个 中 介 输 入 流 (intermediate input 
stream)。 例 如 ， 当 读 入 输入 时 ， 你 经 常 需要 预览 下 一 个 字 节 ， 以 了 解 它 是 否 是 你 想 要 的 值 。 
Java 提供 了 用 于 此 目的 的 PushbackInputStream: 


PushbackInputStream pbin = new PushbackInputStream( 
new BufferedInputStream( 
new FileInputStream("employee.dat"))); 


PLE PR A LATE RTE: 

int b = pbin.read() ; 

并 且 在 它 并 非 你 所 期 望 的 值 时 将 其 推 回 流 中 。 

if (b != '<') pbin.unread(b) ; 

但 是 读 人 和 推 回 是 可 应 用 于 可 回 推 (pushback) 输入 流 的 仅 有 的 方法 。 如 果 你 希望 能 够 预先 
浏览 并 且 还 可 以 读 和 人 数字， 那么 你 就 需要 一 个 既是 可 回 推 输 入 流 ， 又 是 一 个 数据 输入 流 的 引用 。 


DataInputStream din = new DataInputStream( 
pbin = new PushbackInputStream( 
new BufferedInputStream( 
new FileInputStream("employee.dat")))); 


当然 ， 在 其 他 编程 语言 的 输入 /输出 流 类 库 中 ， 诸 如 缓冲 机 制 和 预览 等 细节 都 是 日 动 处 
理 的 。 因 此 ， 相 比较 而 言 ，Java 就 有 一 点 麻烦 ， 它 必须 将 多 个 流 过 滤器 组 合 起 来 。 但 是 ， 这 
种 混合 并 匹配 过 滤器 类 以 构建 真正 有 用 的 输入 /输出 流 序列 的 能 力 ， 将 带 来 极 大 的 灵活 性 ， 
例如 ， 你 可 以 从 一 个 ZIP 压缩 文件 中 通过 使 用 下 面 的 输入 流 序列 来 读 人 数字 (请 参见 图 2-4 ): 


ZipInputStream zin = new ZipInputStream(new FileInputStream("employee.zip")) ; 
DataInputStream din = new DataInputStream(zin) ; 


(请 查看 2.3.3 节 以 了 解 更 多 有 关 Java 处 理 ZIP 文件 功能 的 知识 。) 





图 2-4 过 滤器 流 序列 
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èe FileInputStream(String name) 


eFileInputStream(File file) 
使 用 由 name 字符 串 或 file 对 象 指定 路 径 名 的 文件 创建 一 个 新 的 文件 输入 流 (File 类 在 
本 章 结 尾 处 描述 )。 非 绝对 的 路 径 名 将 按照 相对 于 VM 启动 时 所 设置 的 工作 目录 来 解析 。 





eFileOutputStream(String name) 

eFileOutputStream(String name, boolean append) 

e FileOutputStream(File file) 

eFileOutputStream(File file, boolean append) 
使 用 由 name 字符 串 或 file 对 象 指定 路 径 名 的 文件 创建 一 个 新 的 文件 输出 流 (File 
类 在 本 章 结尾 处 描述 )。 如 果 append 参数 为 true， 那 么 数据 将 被 添加 到 文件 尾 ， 而 
具有 相同 名 字 的 已 有 文件 不 会 被 删除 ; 否则 ， 这 个 方法 会 删除 所 有 具有 相同 名 字 的 已 
有 文件 。 





e BufferedInputStream( InputStream in) 
创建 一 个 带 缓 冲 区 的 输入 流 。 带 缓冲 区 的 输入 流 在 从 流 中 读 入 字符 时 ， 不 会 每 次 都 对 
设备 访问 。 当 缓冲 区 为 空 时 ,会 向 缓冲 区 中 读 入 一 个 新 的 数据 块 。 





pe out) 
创建 一 个 带 缓冲 区 的 输出 流 。 带 缓冲 区 的 输出 流 在 收集 要 写 出 的 字符 时 ， 不 会 每 次 都 
对 设备 访问 。 当 缓冲 区 填 满 或 当 流 被 冲刷 时 ， 数 据 就 被 写 出 。 











e PushbackInputStream( InputStream in) 
e PushbackInputStream( InputStream in, int size) 

构建 一 个 可 以 预览 一 个 字 节 或 者 具有 指定 尺寸 的 回 推 缓冲 区 的 输入 流 。 
e void unread(int b) 

回 推 一 个 字 节 ， 它 可 以 在 下 次 调用 read 时 被 再 次 获取 。 

参数 : b 要 再 次 读 人 的 字 节 。 


2.2 文本 输入 与 输出 
在 保存 数据 时 ， 可 以 选择 二 进 制 格式 或 文本 格式 。 例 如 ， 整 数 1234 存储 成 二 进 制 数 时 ， 
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它 被 写 为 由 字 节 00 00 04 D2 构成 的 序列 (十 六 进 制 表示 法 )， 而 存储 成 文本 格式 时 ， 它 被 
存 成 了 字符 串 “1234”。 尽 管 二 进 制 格式 的 VO 高 速 且 高 效 ， 但 是 不 宜人 来 阅读 。 我 们 首先 
讨论 文本 格式 的 IO， 然 后 在 2.3 节 中 讨论 二 进 制 格式 的 LO。 

在 存储 文本 字符 串 时 ， 需 要 考虑 字符 编码 (character encoding) 方式 。 在 Java 内 部 使 用 
的 UTF-16 编码 方式 中 ， 字 符 串 “1234” 编 码 为 00 31 00 32 00 33 00 34 十 六 进 制 )。 
但 是 ， 许 多 程序 都 希望 文本 文件 按照 其 他 的 编码 方式 编码 。 在 UTF-8 这 种 在 互联 网 上 最 常用 
的 编码 方式 中 ， 这 个 字符 串 将 写 出 为 4A 6F 73 C3 A9， 其 中 并 没有 用 于 前 3 个 字母 的 任何 
0 字 节 ， 而 字符 € 占用 了 两 个 字 节 。 

OutputStreamWriter 类 将 使 用 选 定 的 字符 编码 方式 ， 把 Unicode 码 元 的 输出 流转 换 为 
字 节 流 。 而 InputStreamReader 类 将 包含 字 节 〈 用 某 种 字符 编码 方式 表示 的 字符 ) 的 输入 
流转 换 为 可 以 产生 Unicode 公元 的 读 和 人 能 。 

例如 ， 下 面 的 代码 就 展示 了 如 何 让 一 个 输入 读 入 器 可 以 从 控制 台 读 和 人 键盘 敲 击 信息 ， 并 
将 其 转换 为 Unicode: 


Reader in = new InputStreamReader(System,1n); 


这 个 输入 流 读 人 融会 假定 使 用 主机 系统 所 使 用 的 默认 字符 编码 方式 。 在 果 面 操作 系统 
中 ， 它 可 能 是 像 Windows 1252 或 MacRoman 这 样 的 古老 的 字符 编码 方式 。 你 应 该 总 是 在 
InputStreamReader 的 构造 器 中 选择 一 种 具体 的 编码 方式 。 例 如 ， 


Reader in = new InputStreamReader(new FileInputStream("data.txt"), StandardCharsets.UTF_8) ; 


请 查看 2.2.4 节 以 了 解 字 符 编码 方式 的 更 多 信息 。 
2.2.1 如 何 写 出 文本 输出 


对 于 文本 输出 ， 可 以 使 用 PrintWwriter。 这 个 类 拥有 以 文本 格式 打印 字符 串 和 数字 的 方 
法 ， 它 还 有 一 个 将 PrintwWriter 链接 到 Fi1leWriter 的 便捷 方法 ， 下 面 的 语句 : 

PrintWriter out = new PrintWriter("employee.txt", "UTF-8"); 
等 同 于 : 


PrintWriter out = new PrintWriter( 
new FileQutputStream("employee. txt"), "UTF-8"); 


为 了 输出 到 打印 写 出 器 ， 需 要 使 用 与 使 用 System. out 时 相同 的 print, printin 和 
printf 方法 。 你 可 以 用 这 些 方 法 来 打印 数字 (int 、short 、1ong、f1oat 、doub1le)、 字 符 、 
boolean 值 、 字 符 串 和 对 象 。 

例如 ， 考虑 下 面 的 代码 : 


String name = "Harry Hacker”; 
double salary = 75000; 
out.print(name) ; 

out.print(' '); 
out.print]n(salary) ; 
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它 将 把 下 面 的 字符 : 
Harry Hacker 75000.0 


输出 到 写 出 器 out， 之 后 这 些 字符 将 会 被 转换 成 字 节 并 最 终 写 人 employee.txt 中 。 

printin 方法 在 行 中 添加 了 对 目标 系统 来 说 恰当 的 行 结束 符 〈Windows AZ "\r\n", 
UNIX 系统 是 "n")， 也 就 是 通过 调用 System.getProperty("1ine.separator") 而 获得 
的 字符 串 。 

如 果 写 出 器 设置 为 自动 冲刷 模式 ， 那 么 只 要 printin 被 调用 ,缓冲 区 中 的 所 有 字符 都 
会 被 发 送 到 它们 的 目的 地 (打印 写 出 器 总 是 带 缓冲 区 的 )。 上 默认 情况 下 ， 自 动 冲刷 机 制 是 禁用 
的 ， 你 可 以 通过 使 用 PrintWriter(Writer out, Boolean autoFlush) 来 启用 或 禁用 日 
动 冲刷 机 制 : 


PrintWriter out = new PrintWriter( 
new OutputStreamWriter( 
new FileQutputStream("employee.txt'), "UTF-8"), 
true); // autoflush 


print 方法 不 抛 出 异常 ， 你 可 以 调用 checkError 方法 来 查看 输出 流 是 否 出 现 了 茶 些 

错误 。 

注意 : Java 的 老手 们 可 能 会 很 想 知 道 PrintStream 类 和 System.out 底 怎 么 了 。 在 
Java 1.0 中 ，PrintStream 类 只 是 通过 将 高 字 节 丢弃 的 方式 把 所 有 Unicode 字符 截断 成 
ASCII 字符 。( 那 时 ，Unicode 仍旧 是 16 位 编码 方式 ) 很 明显 ， 这 并 非 一 种 干净 利落 和 
可 移植 的 方式 ， 这 个 问题 在 Java 1.1 中 通过 引入 读 入 器 和 写 出 器 得 到 了 修正 。 为 了 与 已 
有 的 代码 兼 窑 ，System.in、System.out 和 System.err 仍旧 是 输入 /输出 流 而 不 是 
读 入 器 和 写 出 器 。 但 是 现在 PrintStream 类 在 内 部 采用 与 PrintWriter 相同 的 方式 
将 Unicode 字符 转换 成 了 默认 的 主机 编码 方式 。 当 你 在 使 用 print 和 println 方法 时 ， 
PrintStream 类 型 的 对 象 的 行为 看 起 来 确实 很 像 打 印 写 出 器 ， 但 是 与 打印 写 出 器 不 同 的 
是 ， 它 们 允许 我 们 用 write(int) 和 write(byte[]) 方法 输出 原生 字 节 。 





e PrintWriter(Writer out) 


e PrintWriter(Writer writer) 

创建 一 个 向 给 定 的 写 出 器 写 出 的 新 的 PrintWriter。 
e PrintWriter(String filename, String encoding) 
ePrintWriter(File file, String encoding) 

创建 一 个 使 用 给 定 的 编码 方式 回 给 定 的 文件 写 出 的 新 的 PrintWriter. 
e void print(Object obj) 

通过 打印 从 toString 产生 的 字符 串 来 打印 一 个 对 象 。 
evoid print(String s) 
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打印 一 个 包含 Unicode 码 元 的 字符 串 。 
e void printin(String s) 
打印 一 个 字符 串 ， 后面 紧 跟 一 个 行 终 止 符 。 如 果 这 个 流 处 于 自动 冲刷 模式 ， 那 么 就 会 
冲刷 这 个 流 。 
evoid print(char[] s) 
打印 在 给 定 的 字符 串 中 的 所 有 Unicode 码 元 。 
e void print(char c) 
打印 一 个 Unicode 码 元 。 
e void print(int i) 
e void print(long 1) 
e void print(float f) 
e void print(double d) 
e void print(boolean b) 
以 文本 格式 打印 给 定 的 值 。 
e void printf(String format, Object... args) 
按照 格式 字符 串 指定 的 方式 打印 给 定 的 值 。 请 查看 卷 工 第 3 章 以 了 解 格式 化 字符 串 的 
相关 规范 。 
e boolean checkError() 
如 果 产 生 格式 化 或 输出 错误 ， 则 返回 true。 一 旦 这 个 流 碰 到 了 错误 ， 它 就 受到 了 污 
染 ， 并 且 所 有 对 checkError 的 调用 都 将 返回 true, 


2.2.2 ”如何 读 入 文本 输入 


最 简单 的 处 理 任意 文本 的 方式 就 是 使 用 在 卷 1 中 我 们 广泛 使 用 的 Scanner 类 。 我 们 可 以 
从 任何 输入 流 中 构建 Scanner 对 象 。 

或 者 ， 我 们 也 可 以 将 短小 的 文本 文件 像 下 面 这 样 读 入 到 一 个 字符 串 中 : 

String content = new String(Files, readAllBytes(path), charset); 

但 是 ， 如 果 想 要 将 这 个 文件 一 行 行 地 读 和 人 ， 那 么 可 以 调用 : 

List<String> lines = Files,readAllLines(path, charset); 

如 果 文 件 太 大 ， 那 么 可 以 将 行 惰性 处 理 为 一 个 Stream<String> 对 象 : 


try (Stream<String> lines = Files.lines(path, charset)) 


oe? 

在 早期 的 Java 版 本 中 ， 处 理 文本 输入 的 唯一 方式 就 是 通过 BufferedReader #4, EM) 
readLine 方法 会 产生 一 行文 本 ,或 者 在 无 法 获得 更 多 的 输入 时 返回 nu11。 典 型 的 输入 循环 
看 起 来 像 下 面 这 样 : 


‘ 
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InputStream inputStream TTE 

try (BufferedReader in = new BufferedReader (new InputStreamReader(inputStream, 
StandardCharsets .UTF_8))) 

{ 


String line; 
while ((line = in.readLine()) != null) 
{ 


do something with line 
} 
hls, BufferedReader 类 又 有 了 一 个 lines 方法 ， 可 以 产生 一 个 Stream<Stringy> 
对 象 。 但 是 ， 与 Scanner 不 同 ，BufferedReader 没有 用 于 任何 读 人 数字 的 方法 。 


2.2.3 ”以 文本 格式 存储 对 象 


在 本 节 ， 我 们 将 带 你 领略 一 个 示例 程序 ， 它 将 一 个 Employee 记录 数组 存储 成 了 一 个 文 
本 文件 ， 其 中 每 条 记录 都 保存 成 单独 的 一 行 ， 而 实例 字段 彼此 之 间 使 用 分 隔 符 分 离开 ， 这 里 
我 们 使 用 竖 线 (|) HEA CaS C: ) 是 另 一 种 流行 的 选择 ， 有 趣 的 是 ， 每 个 人 都 会 使 用 
不 同 的 分 隔 符 )。 因 此 ， 我 们 这 里 是 在 假设 不 会 发 生 在 要 存储 的 字符 串 中 存在 | 的 情况 。 

下 面 是 一 个 记录 集 的 样本 : 


Harry Hacker|35500|1989-10-01 
Carl Cracker|75000| 1987-12-15 
Tony Tester] 38000| 1990-03-15 


写 出 记录 相当 简单 ， 因 为 我 们 是 要 写 出 到 一 个 文本 文件 中 ， 所 以 我 们 使 用 Printwriter 
类 。 我 们 直接 写 出 所 有 的 字段 ， 每 个 字段 后 面 跟着 一 个 | ， 而 最 后 一 个 字段 的 后 面 跟着 一 个 
\n。 这 项 工作 是 在 下 面 这 个 我 们 添加 到 Employee 类 中 的 writeEmployee 方法 里 完成 的 : 

public static void writeEmployee(PrintWriter out, Employee e) 


out.printin(e.getName() + "|" + e.getSalary() + "|" + e.getHireDay()); 


为 了 读 入 记录 ， 我 们 每 次 读 入 一行， 然后 分 离 所 有 的 字段 。 我 们 使 用 一 个 扫描 需 来 讯 人 
每 一 行 ， 然 后 用 String.split F mle 村 断 开 成 一 组 标记 。 


public static Employee readEmployee(Scanner in) 
{ 
String line = in.nextLineQ); 
String[] tokens = line.split("\\|"); 
String name = tokens [0] ; 
double salary = Double. parseDouble(tokens[1]) ; 
LocalDate hireDate = LocalDate.parse(tokens([2]); 
int year = hireDate.getYear() ; 
int month = hireDate.getMonthValue() ; 
int day = hireDate.getDayOfMonth() ; 
return new Employee(name, salary, year, month, day); 


} 
split FARZ E— THIET Ba FF AY EU GAN, BATT PEAS BEY AR ERS EAT E N 
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表达 式 。 碰 巧 的 是 ， 竖 线 在 正则 表达 式 中 具有 特殊 的 含义 ， 因 此 需要 用 、\ 字符 来 表示 转 义 ， 
而 这 个 \ 又 需要 用 男 一 个 \ 来 转 义 ， 这 样 就 产生 了 “\\| ”表达 式 。 
完整 的 程序 如 程序 清单 2-1 Ro SNA 


void writeData(Employee[] e, PrintWriter out) 

首先 写 出 该 数组 的 长 度 ， 然 后 写 出 每 条 记录 。 静 态 方法 

Employee[] readData(BufferedReader in) 

首先 读 入 该 数组 的 长 度 ， 然 后 读 和 每 条 记录 。 这 显得 稍微 有 点 棘手 : 


int n = in.nextInt(); 
in.nextLine(); // consume newline 
Employee[] employees = new Employee[n] ; 
for (int 1 = 0; i < n; i++) 
{ 
employees[i] = new Employee() ; 
employees [i] .readData(in); 


对 nextInt 的 调用 读 入 的 是 数组 长 度 ， 但 不 包括 行 尾 的 换行 字符 ， 我 们 必须 处 理 掉 这 个 
换行 符 ， 这 样 ， 在 调用 nextLine 方法 后 ，readData 方法 就 可 以 获得 下 一 行 输入 了 。 





package textFile; 


import java.10.*; 
import java.time.*; 
import java.util.*; 


/** 
* @version 1.14 2016-07-11 
* @author Cay Horstmann 
10 */ 
11 public class TextFileTest 
p { 
13 public static void main(String{] args) throws IOException 
14 { 
15 Employee[] staff = new Employee[3]; 
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17 staff[0] = new Employee("Carl Cracker", 75000, 1987, 12, 15); 
18 staff[1] = new Employee("Harry Hacker", 50000, 1989, 10, 1); 
19 staff[2] = new Employee("Tony Tester", 40000, 1990, 3, 15); 


21 // save all employee records to the file employee.dat 

22 try (PrintWriter out = new PrintWriter("employee.dat", "UTF-8")) 
23 { 

24 writeData(staff, out); 

25 } 


27 // retrieve all records into a new array 
28 try (Scanner in = new Scanner( 
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29 new FileInputStream("employee.dat"), "UTF-8")) 
30 { 

31 Employee[] newStaff = readData(in); 

32 

33 // print the newly read employee records 

34 for (Employee e : newStaff) 

35 System.out.printin(e) ; 

36 } 

37 } 

38 

39 /** 

40 * Writes all employees in an array to a print writer 
41 * @param employees an array of employees 

42 * @param out a print writer 

43 */ 


44 private static void writeData(Employee[] employees, PrintWriter out) throws IOException 


46 // write number of employees 

47 out.printin(employees. length) ; 

48 

49 for (Employee e : employees) 

50 writeEmployee(out, e); 

51 } 

52 

53 /** 

54 * Reads an array of employees from a scanner 
55 * @param in the scanner 

56 * @return the array of employees 

57 */ 

58 private static Employee[] readData(Scanner in) 
59 { 

60 // retrieve the array size 

61 int n = in,nextIntQ); 

62 in.nextLine(); // consume newline 

63 

64 Employee[] employees = new Employee[n]; 

65 for (int 1 = 0; 1 < n; i+) 

66 { 

67 employees[i] = readEmployee(in); 

68 

69 return employees; 

70 } 

71 

7? /** 

73 * Writes employee data to a print writer 

74 * @param out the print writer 

75 */ 

76 public static void writeEmployee(PrintWriter out, Employee e) 
77 { 

78 out.println(e.getName() + "|" + e.getSalary() + "|" + e.getHireDay()); 
79 } 

80 

81 [ee 

82 * Reads employee data from a buffered reader 
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83 * @param in the scanner 

84 */ 

85 public static Employee readEmployee(Scanner in) 

86 { 

87 String line = in.nextLine(); 

88 String[] tokens = line.split("\\|"); 

89 String name = tokens [0]; 

90 double salary = Double.parseDouble(tokens[1]); 
91 LocalDate hireDate = LocalDate.parse(tokens[2]); 
92 int year = hireDate.getYear() ; 

93 int month = hireDate.getMonthValue() ; 

94 int day = hireDate.getDayOfMonth() ; 

95 return new Employee(name, salary, year, month, day); 
96 } 

97 } 


2.2.4 字符 编码 方式 


输入 和 输出 流 都 是 用 于 字 节 序列 的 ， 但 是 在 许多 情况 下 ， 我 们 希望 操作 的 是 文本 ， 即 字 
符 序列 。 于 是 ,字符 如 何 编 码 成 字 市 就 成 了 问题 。 

Java 针对 字符 使 用 的 是 Unicode 标准 。 每 个 字符 或 “编码 点 ”都 具有 一 个 21 位 的 整数 。 
有 多 种 不 同 的 字符 编码 方式 ， 也 就 是 说 ， 将 这 些 21 位 数字 包装 成 字 节 的 方法 有 多 种 。 

最 常见 的 编码 方式 是 UTF-8， 它 会 将 每 个 Unicode 编码 点 编码 为 1 到 4 个 字 节 的 序列 
(请 参阅 表 2-1 )。UTF-8 的 好 处 是 传统 的 包含 了 英语 中 用 到 的 所 有 字符 的 ASCII 字符 集中 的 
每 个 字符 都 只 会 占用 一 个 字 节 。 


表 2-1 UTF-8 编码 方式 


字符 范围 编码 方式 
Osa wit 0a,a,a8,8,8,8,a, 
80: 207 FF 110a,,a,a,a,a, 10a,a,a,a,a,a, 
S00...FFFF 1110alsal4alyaly 10allaloaoasa7ag 10a,a,a,a,a,a, 
10000...10FFFF 11110a,,a,,a,, 10€8,,8,,8,,8,,8,38,, 10a,,a,,a,a,a,a, 108,a,a,a,a,a, 


另 一 种 常见 的 编码 方式 是 UTF-16， 它 会 将 每 个 Unicode 编码 点 编码 为 1 个 或 2 个 16 
位 值 (请 参阅 表 2-2 )。 这 是 一 种 在 Java 字符 串 中 使 用 的 编码 方式 。 实 际 上 ， 有 两 种 形式 的 
UTF-16， 被 称 为 “高 位 优先 ”和 “低位 优先 ”。 考 虑 一 下 16 位 值 0x2122。 在 高 位 优先 格式 
中 ， 高 位 字 节 会 先 出 现 : 0x21 后 面 跟着 0x22, 但 是 在 低位 优先 格式 中 ， 是 另外 一 种 排列 方 
式 : 0x22 0x21。 为 了 表示 使 用 的 是 哪 一 种 格式 ， 文 件 可 以 以 “ 字 节 顺序 标记 ”开头 ， 这 个 
标记 为 16 位 数值 0xFEFF。 读 入 器 可 以 使 用 这 个 值 来 确定 字 节 顺序 ， 然 后 丢弃 它 。 


表 2-2 UTF-16 编码 方式 


字符 范围 编码 方式 
Gus oF FFF alsal4alsalzallaloaoag A7VAGALA,A,A,a, ay 
10000. ..10FFFF 110110b,,b,, b,,b,,8,,8,44,38;28,;,;8,, 110111la,a, a,a,a,a,a,a,a,a, 


其 中 blsbisbizble = azoal9alsal7al6 一 1 
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Q 警告 : 有 些 程序 ， 包 括 Microsoft Notepad (微软 记事 本 ) 在 内 ， 都 在 UTF-8 编码 的 文件 
开头 处 添加 了 一 个 字 节 顺序 标记 。 很 明显 ， 这 并 不 需要 ， 因 为 在 UTF-8 中 ， 并 不 存在 字 
节 顺 序 的 问题 。 但 是 Unicode 标准 允许 这 样 做 ， 其 至 认为 这 是 一 种 好 的 做 法 ， 因 为 这 样 
做 可 以 使 编码 机 制 不 留 疑 惑 。 遗 憾 的 是 ，Java 并 没有 这 么 做 ， 有 关 这 个 问题 的 缺陷 报告 
最 终 是 以 “will not fix (不 做 修正 )” 关 闭 的 。 对 你 来 说 ， 最 好 的 做 法 是 将 输入 中 发 现 的 
所 有 先导 的 \UFEFF 都 剥离 掉 。 


除了 UTF 编码 方式 ， 还 有 一 些 编码 方式 ， 它 们 各 自 都 覆盖 了 适用 于 特定 用 户 人 群 的 字符 
范围 。 例 如 ，ISO 8859-1 是 一 种 单字 节 编 码 ， 它 包含 了 西欧 各 种 语言 中 用 到 的 和 沉 有 重音 符号 
的 字符 ， 而 Shift-JIS 是 一 种 用 于 日 文字 符 的 可 变 长 编码 。 大 量 的 这 些 编码 方式 至 今 仍 在 被 广 
泛 使 用 。 

不 存在 任何 可 靠 的 方式 可 以 自动 地 探测 出 字 节 流 中 所 使 用 的 字符 编码 方式 。 茶 些 API 方 
法 让 我 们 使 用 “默认 字符 集 ”"， 即 计算 机 的 操作 系统 首选 的 字符 编码 方式 。 这 种 字符 编码 方 
式 与 我 们 的 字 节 源 中 所 使 用 的 编码 方式 相同 吗 ? 字 节 源 中 的 字 节 可 能 来 目 世 界 上 的 其 他 国家 
或 地 区 ， 因 此 ， 你 应 该 总 是 明确 指定 编码 方式 。 例 如 ， 在 编写 网 页 时 ， 应 该 检查 Content- 
Type 头 信息 。 
注意 : 平台 使 用 的 编码 方式 可 以 由 静态 方法 Charset.defaultCharset 返回 。 静 态 方 

法 Charset.availableCharsets 会 返回 所 有 可 用 的 Charset 实例 ， 返 回 结 果 是 一 个 

从 字符 集 的 规范 名 称 到 Charset 对 象 的 映射 表 。 


& +. Oracle 的 Java 实现 有 一 个 用 于 改 盖 平台 默认 值 的 系统 属性 file.encoding。 但 
是 它 并 非 官 方 支 持 的 属性 ， 并 且 Java 库 的 Oracle 实现 的 所 有 部 分 并 非 都 以 一 致 的 方式 处 
理 该 属性 ， 因 此 ， 你 不 应 该 设置 它 。 

StandardCharsets 类 具有 类 型 为 Charset 的 静态 变量 ， 用 于 表示 每 种 Java 虚拟 机 都 
必须 支持 的 字符 编码 方式 : 


StandardCharsets.UTF 8 
StandardCharsets .UTF_16 
StandardCharsets.UTF_ 16BE 
StandardCharsets.UTF_16LE 
StandardCharsets.IS0_8859_1 
StandardCharsets.US_ ASCII 


为 了 获得 另 一 种 编码 方式 的 Charset ， 可 以 使 用 静态 的 forName 方法 : 

Charset shiftJIS = Charset. forName("Shift-JIS") ; 

在 读 入 或 写 出 文本 时 ， 应 该 使 用 Charset 对 象 。 例 如 ， 我 们 可 以 像 下面 这 样 将 一 个 字 市 
数组 转换 为 字符 串 : 


String str = new String(bytes, StandardCharsets.UTF_8) ; 


O 提示 : 有 些 方法 允许 我 们 用 一 个 Charset 对 象 或 字符 串 来 指定 字符 编码 方式 。 由 于 选择 


的 是 StandardCharsets 常量 ， 所 以 无 需 担 心 拼 写 错 误 。 例 如 ，new String(bytes, 
"UTF 8") 就 不 可 接受 ， 并 且 会 引发 运行 时 错误 。 

Q 警告 : 在 不 指定 任何 编码 方式 时 ， 有 些 方 法 (例如 String(byte[]) 构造 器 ) 会 使 用 默 
认 的 平台 编码 方式 ， 而 其 他 方法 (例如 Files.readA11Lines) 会 使 用 UTF-8。 


2.3 读 写 二 进 制 数据 


文本 格式 对 于 测试 和 调试 而 言 会 显得 很 方便 ， 因 为 它 是 人 类 可 阅读 的 ， 但 是 它 并 不 像 以 
二 进 制 格式 传递 数据 那样 高 效 。 在 下 面 的 各 小 节 中 ， 你 将 会 学 习 如 何 用 二 进 制 数据 来 完成 输 
入 和 输出 。 


2.3.1 Datalnput 和 DataOutput 接口 


DataOutput 接口 定义 了 下 面 用 于 以 二 进 制 格式 写 数组 、 字 符 、boolean 值 和 字符 串 的 
方法 : 

writeChars 
writeByte 
writelnt 
writeShort 
writeLong 
writeFloat 
writeDouble 
writeChar 
writeBoolean 
wri teUTF 


例如 ，writeInt 总 是 将 一 个 整数 写 出 为 4 字 节 的 二 进 制 数 量 值 ， 而 不 管 它 有 多 少 位 ， 
writeDouble 总 是 将 一 个 double 值 写 出 为 8 字 节 的 二 进 制 数量 值 。 这 样 产 生 的 结果 并 非 人 
可 阅读 的 ， 但 是 对 于 给 定 类 型 的 每 个 值 ， 所 需 的 空间 都 是 相同 的 ， 而 且 将 其 读 回 也 比 解析 文 
本 要 更 快 。 


注意 : 根据 你 所 使 用 的 处 理 器 类 型 ， 在 内 存 存储 整数 和 浮 点 数 有 两 种 不 同 的 方法 。 例 
如 ， 假 设 你 使 用 的 是 4 字 节 的 int， 如 果 有 一 个 十 进 制 数 1234， 也 就 是 十 六 进 制 的 4D2 
(1234=4x25$6+13x16+2)， 那 么 它 可 以 按照 内 存 中 4 字 节 的 第 一 个 字 节 存储 最 高 位 字 
节 的 方式 来 存储 为 : 00 00 04 D2， 这 就 是 所 谓 的 高 位 在 前 顺序 (MSB); 我 们 也 可 以 从 
最 低位 字 节 开始 : D2 04 00 00， 这 种 方式 自然 就 是 所 谓 的 低位 在 前 顺序 (LSB )。 例 如 ， 
SPARC 使 用 的 是 高 位 在 前 顺序 , 而 Pentium 使 用 的 则 是 低位 在 前 顺序 。 这 就 可 能 会 带 来 
问题 ， 当 存储 C 或 者 C++ 文件 时 ， 数 据 会 精确 地 按照 处 理 器 存储 它们 的 方式 来 存储 ， 这 
就 使 得 即使 是 最 简单 的 数据 在 从 一 个 平台 迁移 到 另 一 个 平台 上 时 也 是 一 种 挑战 。 在 Java 
中 ， 所 有 的 值 都 按照 高 位 在 前 的 模式 写 出 ， 不 管 使 用 何 种 处 理 器 ， 这 使 得 Java 数据 文件 
可 以 独立 于 平台 。 


华 
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writeUTF 方法 使 用 修订 版 的 8 位 Unicode 转换 格式 写 出 字符 串 。 这 种 方式 与 直接 使 用 
标准 的 UTF-8 编码 方式 不 同 ， 其 中 ，Unicode 码 元 序列 首先 用 UTF-16 表示 ， 其 结果 之 后 使 
用 UTF-8 规则 进行 编码 。 修 订 后 的 编码 方式 对 于 编码 大 于 0xFFFF 的 字符 的 处 理 有 所 不 同 ， 
这 是 为 了 向 后 兼容 在 Unicode 还 没有 超过 16 位 时 构建 的 虚拟 机 。 

因为 没有 其 他 方法 会 使 用 UTF-8 的 这 种 修订 ， 所 以 你 应 该 只 在 写 出 用 于 Java 虚拟 机 的 
字符 串 时 才 使 用 writeUTF 方法 ， 例 如 ， 当 你 需要 编写 一 个 生成 字 节 码 的 程序 时 。 对 于 其 他 
场合 ， 都 应 该 使 用 writeChars 方法 。 

为 了 读 回 数据 ， 可 以 使 用 在 DataInput 接口 中 定义 的 下 列 方法 : 


readInt 
readShort 
readLong 
readFloat 
readDouble 
readChar 
readBool ean 
readUTF 


DataInputStream 类 实现 了 DataInput 接口 ， 为 了 从 文件 中 读 和 人 二进制 数据 ， 可 以 将 
DataInputStream 与 革 个 字 节 源 相 组 合 ， 例 如 FileInputStream: 

DataInputStream in = new DataInputStream(new FileInputStream("employee.dat")) ; 

与 此 类 似 ， 要 想 写 出 二 进 制 数据 ， 你 可 以 使 用 实现 了 Data0utput {xH AY DataOutput— 
Stream 类 . 


DataQutputStream out = new DataQutputStream(new FileQutputStream("employee.dat")); 





e boolean readBoolean( ) 


e byte readByte() 

e char readChar() 

e double readDouble() 

e float readFloat() 

® int readInt() 

e long readLong( ) 

e short readShort() 
读 入 一 个 给 定 类 型 的 值 。 

e void readFully(byte[] b) 
将 字 节 读 和 人 到 数组 b 中 ， 其 间 阻 塞 直 至 所 有 字 节 都 读 人 。 
参数 : b 数据 读 人 的 缓冲 区 

e void readFully(byte[] b, int off, int len) 
将 字 节 读 人 到 数组 b 中 ， 其 间 阻 塞 直 至 所 有 字 节 都 读 人 。 
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参数 : b 数据 读 入 的 缓冲 区 
off 数据 起 始 位 置 的 偏 移 量 
len 读 入 字 节 的 最 大 数量 


e String readUTF() 
读 入 由 “修订 过 的 UTF-8” 格 式 的 字符 构成 的 字符 串 。 
eint skipBytes(int n) 
跳 过 n 个 字 节 ， 其 间 阻 塞 直 至 所 有 字 节 都 被 跳 过 。 
参数 : n 被 跳 过 的 字 节 数 





e void writeBoolean(boolean b) 


e void writeByte(int b) 

e void writeChar(int c) 

e void writeDouble(double d) 

e void writeFloat(float f) 

e void writeInt(int i) 

e void writeLong(long 1) 

e void writeShort(int s) 
写 出 一 个 给 定 类 型 的 值 。 

e void writeChars(String s) 
写 出 字符 串 中 的 所 有 字符 。 

e void writeUTF(String s) 
写 出 由 “修订 过 的 UTF-8” 格 式 的 字符 构成 的 字符 串 。 


2.3.2 ”随机 访问 文件 


RandomAccessFile 类 可 以 在 文件 中 的 任何 位 置 查找 或 写 人 数据 。 磁 盘 文 件 都 是 随机 访 
问 的 ,但 是 与 网 络 套 接 字 通信 的 输入 /输出 流 却 不 是 。 你 可 以 打开 一 个 随机 访问 文件 ， 只 用 
于 读 入 或 者 同时 用 于 读 写 ， 你 可 以 通过 使 用 字符 串 “r ”( 用 于 读 和 访问 ) 或 “rw”( 用 于 读 入 / 
写 出 访问 ) 作为 构造 器 的 第 二 个 参数 来 指定 这 个 选项 。 


RandomAccessFile in = new RandomAccessFile("employee.dat", "r"); 


RandomAccessFile inQut = new RandomAccessFile("employee.dat", "rw"); 


当 你 将 已 有 文件 作为 RandomAccessFile 打开 时 ， 这 个 文件 并 不 会 被 删除 。 

随机 访问 文件 有 一 个 表示 下 一 个 将 被 读 入 或 写 出 的 字 节 所 处 位 置 的 文件 指针 ，seek 方法 
可 以 用 来 将 这 个 文件 指针 设置 到 文件 中 的 任意 字 节 位 置 ，seek 的 参数 是 一 个 1ong 类 型 的 整 
数 ， 它 的 值 位 于 0 到 文件 按照 字 节 来 度量 的 长 度 之 间 。 

getFilePointer 方法 将 返回 文件 指针 的 当前 位 置 。 
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RandomAccessFile 类 同时 实现 了 DataInput FI DataOutput 接口 。 为 了 读 写 随 
机 访问 文件 ， 可 以 使 用 在 前 面 小 节 中 讨论 过 的 诸如 readInt/writeInt 和 readChar/ 
writeChar 之 类 的 方法 。 

我 们 现在 要 剖析 一 个 将 雇员 记录 存储 到 随机 访问 文件 中 的 示例 程序 ， 其 中 每 条 记录 都 拥 
有 相同 的 大 小 ， 这 样 我 们 可 以 很 容易 地 读 入 任何 记录 。 假 设 你 希望 将 文件 指针 置 于 第 三 条 记 
录 处 ， 那 么 你 只 需 将 文件 指针 置 于 恰当 的 字 节 位 置 ， 然 后 就 可 以 开始 读 人 了 。 


long n = 3; 

in.seek((n - 1) * RECORD SIZE); 
Employee e = new Employee(); 

e, readData(in) ; 


如 果 你 希望 修改 记录 ， 然 后 将 其 存 回 到 相同 的 位 置 ， 那 么 请 切记 要 将 文件 指针 置 回 到 这 
条 记录 的 开始 处 : 


in.seek((n - 1) * RECORD SIZE); 
e.writeData(out) ; 


要 确定 文件 中 的 字 节 总 数 ， 可 以 使 用 1ength 方法 ， 而 记录 的 总 数 则 是 用 字 节 总 数 除 以 
每 条 记录 的 大 小 。 


long nbytes = in.lengthQ); // length in bytes 
int nrecords = (int) (nbytes / RECORD SIZE); 


整数 和 浮 点 值 在 二 进 制 格式 中 都 具有 固定 的 尺寸 , 但 是 在 处 理 字 符 串 时 就 有 些 麻烦 了 ， 
因此 我 们 提供 了 两 个 助手 方法 来 读 写 具有 固定 尺寸 的 字符 串 。 

writeFixedString 写 出 从 字符 串 开 头 开始 的 指定 数量 的 码 元 (如 果 码 元 过 少 ， 该 方法 
将 用 0 值 来 补 齐 字 符 串 )。 


public static void writeFixedString(String s, int size, DataQutput out) 
throws IOException 


{ 


for (int 1 = 0; 1 < size; i++) 


char ch = 0; 
if (i < s.length()) ch = s.charAt(i); 
out.writeChar(ch) ; 


} 

readFixedString FEMA MA PIAS A, HERA size ^H, MAA BI 
到 具有 0 值 的 字符 值 ， 然 后 跳 过 输入 字段 中 剩余 的 0 值 。 为 了 提高 效率 ， 这 个 方法 使 用 了 
StringBuilder 类 来 读 入 字符 串 。 

public static String readFixedString(int size, DataInput in) 


throws IOException 


StringBuilder b = new StringBuilder(size) ; 
int 1 = 0; 
boolean more = true; 
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while (more && i < size) 


{ 
char ch = in.readChar(); 
i++} 
if (ch == 0) more = false; 
else b.append(ch) ; 


} 
in.skipBytes(2 * (size - 1)); 
return b.toString(); 

} 


我 们 将 writeFixedString fil readFixedString 方法 放 到 了 Datalo 助手 类 的 内 部 。 
为 了 写 出 一 条 固定 尺寸 的 记录 ， 我 们 直接 以 二 进 制 方式 写 出 所 有 的 字段: 


Datal0.writeFixedString(e.getName(), Employee.NAME_SIZE, out); 
out.writeDouble(e.getSalary()); 

LocalDate hireDay = e.getHireDay(); 
out.writeInt(hireDay.getYear()); 

out .writeInt(hireDay.getMonthValue()) ; 
out.writeInt (hi reDay.getDayOfMonth()) ; 


读 回 数据 也 很 简单 : 


String name = Datal0.readFixedString(Employee.NAME_SIZE, in); 
double salary = in. readDouble() ; 

int y = in.readInt(); 

int m = in, readInt(); 

int d = in.readInt(); 


让 我 们 来 计算 每 条 记录 的 大 小 : 我 们 将 使 用 40 个 字符 来 表示 姓名 字符 串 ， 因 此 ， 每 条 记 
ALS 100 SF: 

e 40 字符 = 80 字 节 ， 用 于 姓名 。 

eldouble=8 字 节 ， 用 于 薪水 。 

e3int=12 字 节 ， 用 于 日 期 。 

程序 清单 2-2 中 所 示 的 程序 将 三 条 记录 写 到 了 一 个 数据 文件 中 ， 然 后 以 闭 序 将 它们 从 文 
件 中 读 回 。 为 了 高 效 地 执行 ， 这 里 需要 使 用 随机 访问 ， 因 为 我 们 需要 首先 读 人 第 三 条 记录 。 








package randomAccess; 


import java.i0.*; 
import java.util.*; 
import java. time. *; 


ak 

* @ersion 1.13 2016-07-11 

* @author Cay Horstmann 

10 */ 

11 public class RandomAccessTest 


oo o Nu Cn ^% A u N e 


3 public static void main(String[] args) throws IOException 


14 { 
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} 


Employee[] staff = new Employee[3]; 


staff[0] = new Employee("Carl Cracker", 75000, 1987, 12, 15): 
staff[1] = new Employee("Harry Hacker", 50000, 1989, 10, 1); 
staff [2] = new Employee("Tony Tester", 40000, 1990, 3, 15); 


try (DataOutputStream out = new DataQutputStream(new FileQutputStream("employee.dat"))) 


// save all employee records to the file employee. dat 
for (Employee e : staff) 
writeData(out, e); 
} 


try (RandomAccessFile in = new RandomAccessFile("employee.dat", "r")) 


{ 


// retrieve all records into a new array 


// compute the array size 
int n = (int)(in.length() / Employee. RECORD SIZE) ; 
Employee[] newStaff = new Employee[n]; 


// read employees in reverse order 
for (int i =n - 1; i >= 0; i--) 


newStaff[i] = new Employee(); 
in.seek(i * Employee.RECORD SIZE); 
newStaff[i] = readData(in): 

} 


// print the newly read employee records 
for (Employee e : newStaff) 
System.out.printIn(e); 
} 


/** 


* Writes employee data to a data output 
* @param out the data output 
* @param e the employee 


学 


public static void writeData(Data0utput out, Employee e) throws IOException 


} 


Datal0.writeFixedString(e.getName(), Employee.NAME SIZE, out); 
out.writeDouble(e.getSalary()); 


LocalDate hireDay = e.getHireDay(); 
out.writeInt (hi reDay.getYear()); 
out.writeInt (hi reDay.getMonthValue()): 
out.writeInt (hi reDay.getDayOfMonth()); 


/** 


* Reads employee data from a data input 
* @param in the data input 
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69 * @return the employee 

70 */ 

71 public static Employee readData(DataInput in) throws IOException 
72 { 

23 String name = Datal0.readFixedString(Employee.NAME_SIZE, in); 
74 double salary = in.readDouble() ; 

75 int y = in.readInt(); 

76 int m = in.readInt(); 

17 int d = in, readIntQ); 

78 return new Employee(name, salary, y, m - 1, d); 

79 } 

80 } 





e RandomAccessFile(String file, String mode) 
e RandomAccessFile(File file, String mode) 
参数 : file 要 打开 的 文件 
mode “r” 表 示 只 读 模式 ;“ rw” 表 示 读 / 写 模式 ;“ rws ”表示 每 次 更 新 
时 ， 都 对 数据 和 元 数据 的 写 磁盘 操作 进行 同步 的 读 / 写 模式 ; “rwd 
表示 每 次 更 新 时 ， 只 对 数据 的 写 磁盘 操作 进行 同步 的 读 / 写 模式 
èe long getFilePointer() 
返回 文件 指针 的 当前 位 置 。 
e void seek( long pos) 
将 文件 指针 设置 到 距 文 件 开 头 pos 个 字 市 处 。 
èe long length() 
返回 文件 按照 字 节 来 度量 的 长 度 。 


2.3.3 ZIP 文档 


ZIP 文档 (通常 ) 以 压缩 格式 存储 了 一 个 或 多 个 文件 ， 每 个 ZIP 文档 都 有 一 个 头 ， 包 含 诸 
如 每 个 文件 名 字 和 所 使 用 的 压缩 方法 等 信息 。 在 Java 中 ， 可 以 使 用 ZipInputStream 来 读 
A ZIP 文档 。 你 可 能 需要 浏览 文档 中 每 个 单独 的 项 ，getNextEntry 方法 就 可 以 返回 一 个 摘 
述 这 些 项 的 ZipEntry 类 型 的 对 象 。 回 ZipInputstream 的 get InputStream 方法 传递 该 
项 可 以 获取 用 于 读 取 该 项 的 输入 流 。 然 后 调用 closeEntry 来 读 人 下 一 项 。 下 面 是 典型 的 通 
读 ZIP 文件 的 代码 序列 : 


ZipInputStream zin = new ZipInputStream(new FileInputStream(zi pname)) ; 
ZipEntry entry; 
while ((entry = zin.getNextEntry()) != null) 


InputStream in = zin.getInputStream(entry) ; 
read the contents of in 
zin.closeEntry() ; 
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zin.close(); | 

Be th Bl ZIP 文件， 可 以 使 用 ZipoutputStream， 而 对 于 你 希望 放 人 到 ZIP 文件 中 的 
每 一 项 ， 孝 应 该 创建 一 个 ZipEntry 对 象 ， 并 将 文件 名 传递 给 ZipEntry 的 构造 器 ， 它 将 设 
置 其 他 诸如 文件 日 期 和 解压 缩 方 法 等 参数 。 如 果 需 要 ， 你 可 以 覆盖 这 些 设置 。 然 后 ， 你 需要 
调用 ZipoutputStream 的 putNextEntry 方法 来 开始 写 出 新 文件 ， 并 将 文件 数据 发 送 到 
ZIP 输出 流 中 。 当 完成 时 ， 需 要 调用 closeEntry。 然 后 ， 你 需要 对 所 有 你 希望 存储 的 文件 
都 重复 这 个 过 程 。 下 面 是 代码 框架 : 


FileQutputStream fout = new File0utputStream("test,zip")， 
ZipOutputStream zout = new ZipOutputStream(fout) ; 

for all files 

{ 


ZipEntry ze = new ZipEntry(filename) ; 
zout. putNextEntry (ze) ; 

send data to zout 

zout.closeEntry() ; 


zout.close(); 


itm: JAR 文件 (在 卷 工 第 13 章 中 讨论 过 ) 只 是 带 有 一 个 特殊 项 的 ZIP 文件 ， 这 个 项 称 

作 清 单 。 你 可 以 使 用 JarInputStream fe JarOutputStream 类 来 读 写 清单 项 。 

ZIP 输入 流 是 一 个 能 够 展示 流 的 抽象 化 的 强大 之 处 的 实例 。 当 你 读 入 以 压缩 格式 存储 的 
数据 时 ， 不 必 担 心 边 请 求 边 解压 数据 的 问题 ， 而 且 ZIP 格式 的 字 节 源 并 非 必须 是 文件 ， 也 可 
以 是 来 目 网 络 连接 的 ZIP 数据 。 事 实 上 ， 当 Applet 的 类 加 载 器 读 人 JAR 文件 时 ， 它 就 是 在 
读 人 和 解压 来 自 网 络 的 数据 。 


EE] 注意 : 2.5.8 节 将 展示 如 何 使 用 Java SE7 4 FileSystem 类 而 无 需 特殊 API 来 访问 ZIP 
文档 。 





e ZipInputStream( InputStream in) 
创建 一 个 ZipInputStream， 使 得 我 们 可 以 从 给 定 的 InputStream 向 其 中 填充 数据 。 
eZipEntry getNextEntry() 
为 下 一 项 返回 ZipEntry 对 象 ， 或 者 在 没有 更 多 的 项 时 返回 nu11。 
e void closeEntry() 
关闭 这 个 ZP 文 件 中 当前 打开 的 项 。 之 后 可 以 通过 使 用 getNextEntry() 读 入 下 
一 项 。 






e ZipOutputStream(OutputStream out) 
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创建 一 个 将 压缩 数据 写 出 到 指定 的 OutputStream 的 ZipOutputStream, 
evoid putNextEntry(ZipEntry ze) 
将 给 定 的 ZipEntry 中 的 信息 写 出 到 输出 流 中 ， 并 定位 用 于 写 出 数据 的 流 ， 然 后 这 些 
数据 可 以 通过 write) 写 出 到 这 个 输出 流 中 。 
e void closeEntry() 
关闭 这 个 ZIP 文件 中 当前 打开 的 项 。 使 用 putNextentry 方法 可 以 开始 下 一 项 。 
e void setLevel(int level) 
设置 后 续 的 各 个 DEFLATED 项 的 默认 压缩 级 别 。 这 里 默认 值 是 Deflater . DEFAULT_ 
COMPRESSION。 如 果 级 别 无 效 ， 则 抛 出 111egalArgumentException, 
参数 : level 压缩 级 别 ， 从 0(NO_COMPRESSION) 到 9(BEST_COMPRESSION) 
evoid setMethod(int method) 
设置 用 于 这 个 ZipoutputStream 的 默认 压缩 方法 ， 这 个 压缩 方法 会 作用 于 所 有 没有 
指定 压缩 方法 的 项 上 。 
参数 : method ”压缩 方法 ，DEFLATED 或 STORED 





e ZipEntry(String name) 
用 给 定 的 名 字 构 建 一 个 Zip 项 。 
参数 : name 这 一 项 的 名 字 
è long getCrc() 
返回 用 于 这 个 ZipEntry 的 CRC32 校 验 和 的 值 。 
e String getName'( ) 
返回 这 一 项 的 名 字 。 
è long getSize() 
返回 这 一 项 未 压缩 的 尺寸 ， 或 者 在 未 压缩 的 尺寸 不 可 知 的 情况 下 返回 -1。 
e boolean isDirectory() 
当 这 一 项 是 目录 时 返回 true, 
e void setMethod(int method) 
参数 : method ”用 于 这 一 项 的 压缩 方法 ， 必 须 是 DEFLATED 或 STORED 
e void setSize(long size) 
设置 这 一 项 的 尺寸 ， 只 有 在 压缩 方法 是 STORED 时 才 是 必需 的 。 
参数 : size 这 一 项 未 压缩 的 尺寸 
e void setCrc(long crc) 
给 这 一 项 设置 CRC32 校 验 和 ， 这 个 校 验 和 是 使 用 CRC32 类 计算 的 。 只 有 在 压缩 方法 
是 STORED 时 才 是 必需 的 。 
参数 : crc 这 一 项 的 校 验 和 





66 Jaa SRK Al ZRH 





e ZipFile(String name) 
eZipFile(File file) 
创建 一 个 ZipFile， 用 于 从 给 定 的 字符 串 或 File 对 象 中 读 入 数据 。 
e Enumeration entries() 
返回 一 个 Enumeration 对 象 ， 它 枚 举 了 描述 这 个 ZipFile 中 各 个 项 的 ZipEntry 对 象 。 
eZipEntry getEntry(String name) 
返回 给 定名 字 所 对 应 的 项 ， 或 者 在 没有 对 应 项 的 时 候 返 回 nu11。 
参数 : name 项 名 
e InputStream getInputStream(ZipEntry ze) 
返回 用 于 给 定 项 的 InputStream, 
HH: ze 这 个 ZIP 文件 中 的 一 个 ZipEntry 
e String getName( ) 
返回 这 个 ZIP 文件 的 路 径 。 


2.4 WRIA / 输出 流 与 序列 化 


当 你 需要 存储 相同 类 型 的 数据 时 ， 使 用 固定 长 度 的 记录 格式 是 一 个 不 错 的 选择 。 但 是 ， 
在 面 回 对 象 程序 中 创建 的 对 象 很 少 全 部 都 具有 相同 的 类 型 。 例 如 ， 你 可 能 有 一 个 称 为 staff 
的 数组 ， 它 名 义 上 是 一 个 Emp1oyee 记录 数组 ， 但 是 实际 上 却 包 含 诸如 Manager 这 样 的 子 
类 实例 。 

我 们 当然 可 以 自己 设计 出 一 种 数据 格式 来 存储 这 种 多 态 集合 ， 但 是 幸运 的 是 ， 我 们 并 不 
需要 这 么 做 。Java 语言 支持 一 种 称 为 对 象 序列 化 (object serialization) 的 非常 通用 的 机 制 ， 它 
可 以 将 任何 对 象 写 出 到 输出 流 中 ， 并 在 之 后 将 其 读 回 。( 你 将 在 本 章 稍 后 看 到 “序列 化 ”这 个 
术语 的 出 处 。) 


2.4.1 保存 和 加 载 序列 化 对 象 
为 了 保存 对 象 数据 ， 首 先 需 要 打开 一 个 0bject0utputStream WE: 


ObjectOutputStream out = new ObjectOutputStream(new FileQutputStream("employee.dat")); 


现在 ， 为 了 保存 对 象 ， 可 以 直接 使 用 0bjectoutputSstream 的 writeObject 方法 ， 如 下 
所 示 : 


Employee harry = new Employee("Harry Hacker", 50000, 1989, 10, 1); 
Manager boss = new Manager("Carl Cracker", 80000, 1987, 12, 15); 
out.writeObject (harry) ; 

out.writeObject (boss) ; 


为 了 将 这 些 对 象 读 回 ， 首 先 需 要 获得 一 个 0bjectInputSstream WE: 


华 
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ObjectInputStream in = new ObjectInputStream(new FileInputStream("employee.dat”)) ; 
然后 ， 用 readObject 方法 以 这 些 对 象 被 写 出 时 的 顺序 获得 它们 : 


Employee el = (Employee) in.readObject(); 
Employee e2 = (Employee) in.readObject(); 


但 是 ， 对 希望 在 对 象 输出 流 中 存储 或 从 对 象 输入 流 中 恢复 的 所 有 类 都 应 进行 一 下 修改 ， 这 些 
类 必须 实现 Serializable 接口 : 

class Employee implements Serializable { . . . } 

Serializable 接口 没有 任何 方法 ， 因 此 你 不 需要 对 这 些 类 做 任何 改动 。 在 这 一 点 上 ， 
它 与 在 卷 I 第 6 章 中 讨论 过 的 Cloneable 接口 很 相似 。 但 是 ， 为 了 使 类 可 克隆 ， 你 仍旧 需 
要 覆盖 Object 类 中 的 clone 方法 ， 而 为 了 使 类 可 序列 化 ， 你 不 需要 做 任何 事 。 


注意 : 你 只 有 在 写 出 对 象 时 才能 用 writeObject/readObject 方法 ， 对 于 基本 类 型 值 ， 
你 需要 使 用 诸如 writeInt/readInt & writeDouble/readDouble 这 样 的 方法 。( 对 
象 流 类 都 实现 了 Datalnput/DataOutput 接口 。) 


在 幕后 ， 是 ObjectOutputStream 在 浏览 对 象 的 所 有 域 ， 并 存储 它们 的 内 容 。 例 如 ， 
当 写 出 一 个 Employee 对 象 时 ， 其 名 字 、 日 期 和 薪水 域 都 会 被 写 出 到 输出 流 中 。 

但 是 ， 有 一 种 重要 的 情况 需要 考虑 ， 当 一 个 对 象 被 多 个 对 象 共 享 ， 作 为 它们 各 上 自 状态 的 
一 部 分 时 ， 会 发 生 什么 呢 ? 

为 了 说 明 这 个 问题 ， 我 们 对 Manager 类 稍微 做 些 修 改 ， 假设 每 个 经 理 都 有 一 个 秘书 : 


class Manager extends Employee 
private Employee secretary; 


} 
现在 每 个 Manager 对 象 都 包含 一 个 表示 秘书 的 Employee 对 象 的 引用 ， 当 然 ， 两 个 经 理 
可 以 共用 一 个 秘书 ， 正 如 图 2-5 和 下 面 的 代码 所 示 的 那样 : 


harry = new Employee("Harry Hacker", . . .); 
Manager carl = new Manager("Carl Cracker", . . .); 
carl.setSecretary (harry) ; 

Manager tony = new Manager("Tony Tester", . . .); 
tony. setSecretary (harry) ; 


保存 这 样 的 对 象 网 络 是 一 种 挑战 ， 在 这 里 我 们 当然 不 能 去 保存 和 恢复 秘书 对 象 的 内 存 地 
址 ， 因 为 当 对 象 被 重新 加 载 时 ， 它 可 能 占据 的 是 与 原来 完全 不 同 的 内 存 地 址 。 

与 此 不 同 的 是 ， 每 个 对 象 都 是 用 一 个 序列 号 ( serial number) 保存 的 ， 这 就 是 这 种 机 制 之 
所 以 称 为 对 象 序列 化 的 原因 。 下 面 是 其 算法 : 

e 对 你 遇 到 的 每 一 个 对 象 引用 都 关联 一 个 序列 号 (如 图 2-6 Pras). 

o 对 于 每 个 对 象 ， 当 第 一 次 遇 到 时 ， 保 存 其 对 象 数 据 到 输出 流 中 。 

e 如 果 某 个 对 象 之 前 已 经 被 保存 过 ， 那 么 只 写 出 “与 之 前 保存 过 的 序列 号 为 x 的 对 象 相 同 ”。 


68 Java SRR Al SAH 





oi a i TERN ll 
Manager 





图 2-5 两 个 经 理 可 以 共用 一 个 共有 的 雇员 








{serial number = 1 
~f type = Employee 
本 name = "Harry Hacker" 








name = | "Harry Hacker" 





{serial number = 2 
“| type = Manager 

|_| Name = "Carl Cracker’ 
| secretary = object 1 








serial number = 3 


图 2-6 ”一 个 对 象 序列 化 的 实例 







B2E RABE 69 


在 读 回 对 象 时 ， 整 个 过 程 是 反 过 来 的 。 

o 对 于 对 象 输入 流 中 的 对 象 ， 在 第 一 次 遇 到 其 序列 号 时 ， 构 建 它 ， 并 使 用 流 中 数据 来 初 
始 化 它 ， 然 后 记录 这 个 顺序 号 和 新 对 象 之 间 的 关联 。 

o 当 遇 到 “与 之 前 保存 过 的 序列 号 为 x 的 对 象 相同 ”标记 时 ， 获 取 与 这 个 顺序 号 相关 联 
的 对 象 引 用 。 


注意 : 在 本 章 中 ,我 们 使 用 序列 化 将 对 象 集合 保存 到 磁盘 文件 中 ， 并 按照 它们 被 存储 的 
样子 获取 它们 。 序 列 化 的 另 一 种 非常 重要 的 应 用 是 通过 网 络 将 对 象 集合 传送 到 另 一 台 计 
算 机 上 。 正 如 在 文件 中 保存 原生 的 内 存 地 址 毫 无 意义 一 样 ， 这 些 地 址 对 于 在 不 同 的 处 理 
器 之 间 的 通信 也 是 毫 无 意义 的 。 因 为 序列 化 用 序列 号 代替 了 内 存 地 址 ， 所 以 它 允 许 将 对 
象 集 合 从 一 台 机 器 传送 到 另 一 台 机 器 。 


程序 清单 2-3 是 保存 和 重新 加 载 Employee 和 Manager 对 象 网 络 的 代码 (有 些 对 象 共 享 
pet ote nie on 
复 时 ， KEPER secretary 域 中 。 





1 package objectStream; 

2 

3 Import java.io.*; 

4 

5 /** 

6 * @version 1.10 17 Aug 1998 
7 * @author Cay Horstmann 

8 */ 

9 class ObjectStreamTest 


1 public static void main(String[] args) throws IOException, ClassNotFoundException 


13 Employee harry = new Employee("Harry Hacker", 50000, 1989, 10, 1); 

14 Manager carl = new Manager("Carl Cracker", 80000, 1987, 12, 15); 

15 car].setSecretary (harry); 

16 Manager tony = new Manager("Tony Tester", 40000, 1990, 3, 15); 

17 tony.setSecretary (harry); 

18 

19 Employee[] staff = new Employee [3] ; 

20 

21 staff[0] = carl; 

22 staff[1] = harry; 

23 staff[2] = tony; 

24 

25 // save all employee records to the file employee. dat 

26 try (ObjectOutputStream out = new ObjectOutputStream(new FileOutputStream("employee.dat"))) 
27 

28 out.writeObject (staff) ; 

29 } 

30 

31 try (ObjectInputStream in = new ObjectInputStream(new FileInputStream("emp]oyee.dat"))) 


/ 
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32 { 

33 // retrieve all records into a new array 
34 

35 Employee[] newStaff = (Employee[]) in. readObject() ; 
36 

37 // raise secretary's salary 

38 newStaff[1].raiseSalary(10) ; 

39 

40 // print the newly read employee records 
41 for (Employee e : newStaff) 

42 System.out.print]n(e) ; 

43 

44 } 

45 } 





e ObjectOutputStream(OutputStream out) 
创建 一 个 ObjectoutputSstream 使 得 你 可 以 将 对 象 写 出 到 指定 的 OutputStream, 

è void writeObject(Object obj) 
写 出 指定 的 对 象 到 0bject0utputStream， 这 个 方法 将 存储 指定 对 象 的 类 、 类 的 签名 
以 及 这 个 类 及 其 超 类 中 所 有 非 静态 和 非 瞬 时 的 域 的 值 。 





e ObjectInputStream( InputStream in) 
创建 一 个 objectInputStream 用 于 从 指定 的 InputStream 中 读 回 对 象 信息 。 

e Object readObject() 
从 ObjectInputStream 中 读 入 一 个 对 象 。 特 别 是 ， 这 个 方法 会 读 回 对 象 的 类 、 类 的 
签名 以 及 这 个 类 及 其 超 类 中 所 有 非 静态 和 非 瞬 时 的 域 的 值 。 它 执行 的 反 序列 化 允许 恢 
复 多 个 对 象 引 用 。 


2.4.2 理解 对 象 序列 化 的 文件 格式 


对 象 序列 化 是 以 特殊 的 文件 格式 存储 对 象 数据 的 ， 当 然 ， 你 不 必 了 解 文件 中 表示 对 象 的 
确切 字 节 序列 ， 就 可 以 使 用 write0bject/read0bject 方法 。 但 是 ， 我 们 发 现 研 究 这 种 数 
据 格 式 对 于 洞察 对 象 流 化 的 处 理 过 程 非 常 有 益 。 因 为 其 细节 显得 有 些 专业 ， 所 以 如 果 你 对 其 
实现 不 感 兴 趣 ， 则 可 以 跳 过 这 一 万。 

每 个 文件 都 是 以 下 面 这 两 个 字 节 的 “魔幻 数字 ”开始 的 


AC ED 
Ja AIR A IAP CRASS, HAE 
00 05 
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(我 们 在 本 节 中 统一 使 用 十 六 进 制 数字 来 表示 字 节 。) 然后 ， 是 它 包 含 的 对 象 序列 ， 其 顺 
序 即 它们 存储 的 顺序 。 

字符 串 对 象 被 存 为 

74 ”两 字 节 表 示 的 字符 串 长 度 所 有 字符 

an, FP “Harry” WFX 

74 00 05 Harry 


字符 串 中 的 Unicode 字符 被 存储 为 修订 过 的 UTF-8 格式 。 

当 存 储 一 个 对 象 时 ， 这 个 对 象 所 属 的 类 也 必须 存储 。 这 个 类 的 描述 包含 

EST 

e 序列 化 的 版 本 唯一 的 ID ， 它 是 数据 域 类 型 和 方法 签名 的 指纹 。 

e 描述 序列 化 方法 的 标志 集 。 

o 对 数据 域 的 描述 。 

指纹 是 通过 对 类 、 超 类 、 接 口 、 域 类 型 和 方法 签名 按照 规范 方式 排序 ， 然 后 将 安全 散 列 
算法 (SHA) 应 用 于 这 些 数据 而 获得 的 。 

SHA 是 一 种 可 以 为 较 大 的 信息 块 提 供 指 纹 的 快速 算法 ,不 论 最 初 的 数据 块 尺寸 有 多 大 ， 
这 种 指纹 总 是 20 个 字 节 的 数据 包 。 它 是 通过 在 数据 上 执行 一 个 灵巧 的 位 操作 序列 而 创建 的 ， 
这 个 序列 在 本 质 上 可 以 百分之百 地 保证 无 论 这 些 数据 以 何 种 方式 发 生变 化 ， 其 指纹 也 都 会 
跟着 变化 。( 关 于 SHA 的 更 多 细节 ， 可 以 查看 一 些 参考 资料 ， 例 如 William Stallings 所 车 的 
《 Cryptography and Network Security: Principles and Practice 》 第 7 版 [Prentice Hall, 2016]。) 
但 是 ， 序 列 化 机 制 只 使 用 了 SHA 码 的 前 8 个 字 节 作为 类 的 指纹 。 即 便 这 样 ， 当 类 的 数据 域 
或 方法 发 生变 化 时 ， 其 指纹 跟着 变化 的 可 能 性 还 是 非常 大 。 

在 读 入 一 个 对 象 时 ， 会 拿 其 指纹 与 它 所 属 的 类 的 当前 指纹 进行 比 对 ， 如 果 它 们 不 匹配 ， 
那么 就 说 明 这 个 类 的 定义 在 该 对 象 被 写 出 之 后 发 生 过 变化 ， 因 此 会 产生 一 个 异常 。 在 实际 情 
况 下 ， 类 当然 是 会 演化 的 ， 因 此 对 于 程序 来 说 ， 读 入 较 旧 版 本 的 对 象 可 能 是 必需 的 。 我 们 将 
在 2.4.5 节 中 讨论 这 个 问题 。 

下 面 表示 了 类 标识 符 是 如 何 存 储 的 : 

e72 

o 2 FIWA KE 

e 类 名 

e 8 FIKA 

e 1 字 贡 长 的 标志 

o 2 字 节 长 的 数据 域 描述 符 的 数量 

o 数据 域 描述 符 

o 78 (结束 标记 ) 

o 超 类 类 型 (如果 没 有 就 是 70) 
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标志 字 节 是 由 在 Gava.io.ObjectStreamConstants 中 定义 的 3 位 掩 码 构成 的 . 


Static final byte SC WRITE METHOD = 1; 

// class has a writeObject method that writes additional data 
Static final byte SC_SERIALIZABLE = 2; 

// class implements the Serializable interface 
Static final byte SC_EXTERNALIZABLE = 4; 

// class implements the Externalizable interface 


我 们 会 在 本 章 稍 后 讨论 Externalizable 接口 。 可 外 部 化 的 类 提供 了 定制 的 接管 其 实例 
域 输出 的 读 写 方法 。 我 们 要 写 出 的 这 些 类 实现 了 Serializable 接口 ， 并 且 其 标志 值 为 02， 
而 可 序列 化 的 java.uti1.Date 类 定义 了 它 自己 的 read0bject/write0bject 方法 ， 并 且 


其 标志 值 为 03。 
每 个 数据 域 描述 符 的 格式 如 下 : 
e 1 字 市 长 的 类 型 编码 
e 2 字 廊 长 的 域名 长 度 
o 域名 
e 类 名 (如 果 域 是 对 象 ) 
其 中 类 型 编码 是 下 列 取 值 之 一 : 
B byte 
C char 
D double 
F float 
I int 
J long 
L 对 象 
S short 
Z boolean 
[ 数组 


当 类 型 编码 为 L 时 ， 域 名 后 面 紧 跟 域 的 类 型 。 类 名 和 域名 字符 串 不 是 以 字符 串 编 码 
74 开头 的 ， 但 域 类 型 是 。 域 类 型 使 用 的 是 与 域名 稍 有 不 同 的 编码 机 制 ， 即 本 地 方法 使 用 的 
格式 。 

例如 ，Emp1oyee 类 的 薪水 域 被 编码 为 : 

D 00 06 salary 

下 面 是 Employee 类 完整 的 类 描述 符 : 

72 00 08 Employee 


E6 D2 86 7D AE AC 18 1B 02 指纹 和 标志 

00 03 实例 域 的 数量 

D 00 06 salary 实例 域 的 类 型 和 名 字 
L 00 07 hireDay 实例 域 的 类 型 和 名 字 


化 音 IT 
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74 00 10 Ljava/util/Date; 实例 域 的 类 名 一 一 Date 

L 00 04 name 实例 域 的 类 型 和 名 字 

74 00 12 Ljava/lang/String; 实例 域 的 类 名 一 一 String 
78 结束 标记 

70 无 超 类 


这 些 描述 符 相 当 长 ， 如 果 在 文件 中 再 次 需要 相同 的 类 描述 符 ， 可 以 使 用 一 种 缩写 版 : 
71 4 字 节 长 的 序列 号 

这 个 序列 号 将 引用 到 前 面 已 经 描述 过 的 类 描述 符 ， 我 们 稍 后 将 讨论 编号 模式 。 

对 象 将 被 存储 为 : 


73 类 描述 符 对 象 数据 

例如 ， 下 面 展 示 的 就 是 Employee 对 象 如 何 存储 : 

40 E8 6A 00 00 00 00 00 salary 域 的 值 一 一 double 

73 hireDate 域 的 值 一 一 新 对 象 
71 00 7E 00 08 已 有 的 类 java/uti1/Date 
77 08 00 00 00 91 1B 4E B1 80 78 外 部 存储 一 一 稍 后 讨论 细节 

74 00 0C Harry Hacker name 域 的 值 一 一 String 


正如 你 所 看 见 的 ， 数 据 文件 包含 了 足够 的 信息 来 恢复 这 个 Employee 对 象 。 

数组 总 是 被 存储 成 下 面 的 格式 : 

75 类 描述 符 4 字 节 长 的 数组 项 的 数量 数组 项 

在 类 描述 符 中 的 数组 类 名 的 格式 与 本 地 方法 中 使 用 的 格式 相同 〈 它 与 在 其 他 的 类 描述 符 
中 的 类 名 稍微 有 些 差异 )。 在 这 种 格式 中 ， 类 名 以 上 开头， 以 分 号 结束 。 

例如 ，3 个 Emp1oyee 对 象 构成 的 数组 写 出 时 就 像 下 面 一 样 : 


75 数组 
72 00 0B [LEmployee; 新 类 ， 字 符 串 长 度 ， 类 名 EmployeeL] 
FC BF 36 11 C5 91 11 C7 02 指纹 和 标志 
00 00 实例 域 的 数量 
78 结束 标记 
70 无 超 类 
00 00 00 03 数组 项 的 数量 


注意 ，Emp1oyee 对 象 数 组 的 指纹 与 Emp1oyee 类 目 身 的 指纹 并 不 相同 。 

所 有 对 象 (包含 数组 和 字符 串 ) 和 所 有 的 类 描述 符 在 存储 到 输出 文件 时 都 被 赋予 了 一 个 
序列 号 ， 这 个 数字 以 00 7E 00 00 开头 。 

我 们 已 经 看 到 过 ， 任 何 给 定 的 类 其 完整 的 类 描述 符 只 保存 一 次 ,后续 的 描述 符 将 引用 
它 。 例 如 ， 在 前 面 的 示例 中 ， 对 Date 类 的 重复 引用 就 被 编码 为 : 


71 00 7E 00 08 
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相同 的 机 制 还 被 用 于 对 象 。 如 果 要 写 出 一 个 对 之 前 存储 过 的 对 象 的 引用 ， 那 么 这 个 引用 
也 会 以 完全 相同 的 方式 存储 ， 即 71 后 面 跟随 序列 号 ， 从 上 下 文中 可 以 很 清楚 地 了 解 这 个 特 
殊 的 序列 引用 表示 的 是 类 描述 符 还 是 对 象 。 


最 后 ， 空 引用 被 存储 为 : 
70 


下 面 是 前 面 小 节 中 0bjectRefTest 程序 的 带 注 释 的 输出 。 如 果 你 喜欢 ， 可 以 运行 这 个 
程序 ， 然 后 查看 其 数据 文件 emp1oyee .dat 的 十 六 进 制 码 ， 并 将 其 与 注释 列表 比较 。 在 输出 
中 接近 结束 部 分 的 几 行 重要 编码 展示 了 对 之 前 存储 过 的 对 象 的 引用 。 


AC ED 00 05 
75 
72 00 0B [LEmployee; 
FC BF 36 11 C5 91 11 C7 02 
00 00 
78 
70 
00 00 00 03 
73 
72 00 07 Manager 
36 06 AE 13 63 8F 59 B7 02 
00 01 
L 00 09 secretary 
74 00 0A LEmployee; 
78 
72 00 08 Employee 
E6 D2 86 7D AE AC 18 1B 02 
00 03 
D 00 06 salary 
L 00 07 hireDay 
74 00 10 Ljava/util/Date; 
L 00 04 name 
74 00 12 Ljava/lang/String; 
78 
70 
40 F3 88 00 00 00 00 00 
73 
72 00 OE java.util.Date 
68 6A 81 01 4B 59 74 19 03 
00 00 


文件 头 

数组 staff (序列 #1) 

新 类 、 字 符 串 长 度 、 类 名 EmployeeL] (序列 #0) 
指纹 和 标志 

实例 域 的 数量 

结束 标记 

无 超 类 

数组 项 的 数量 

staff[0] 一 一 新 对 象 (序列 #7) 

新 类 、 字 符 串 长 度 、 类 名 (序列 #2) 


指纹 和 标志 

数据 的 数量 

实例 域 的 类 型 和 名 字 

实例 域 的 类 名 一 一 String (序列 #3) 
结束 标记 

超 类 一 一 新 类 、 字 符 串 长 度 、 类 名 (序列 #4) 
指纹 和 标志 

实例 域 的 数量 

实例 域 的 类 型 和 名 字 
实例 域 的 类 型 和 名 字 

实例 域 的 类 名 一 一 String (序列 #5) 
实例 域 的 类 型 和 名 字 

实例 域 的 类 名 一 一 String (序列 #6) 
结束 标记 

无 超 类 


salary 域 的 值 一 一 double 

hireDate 域 的 值 一 一 新 对 象 (序列 #9) 
新 类 、 字 符 串 长 度 、 类 名 【序列 #8) 
指纹 和 标志 

无 实例 变量 





78 
70 
77 08 
00 00 00 83 E9 39 E0 00 
78 
74 00 0C Carl Cracker 
73 
71 00 7E 00 04 
40 £8 6A 00 00 00 00 00 
73 
71 00 7E 00 08 
77 08 
00 00 00 91 1B 4E B1 80 
78 
74 00 0C Harry Hacker 
71 00 7E 00 0B 
73 
71 00 7E 00 02 
40 E3 88 00 00 00 00 00 
73 
71 00 7E 00 08 
77 08 
00 00 00 94 6D 3E EC 00 00 
78 
74 00 0B Tony Tester 
71 00 7E 00 0B 
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结束 标记 

无 超 类 

外 部 存储 、 字 节 的 数量 

日 期 

结束 标记 

name 域 的 值 一 一 String (序列 #10) 
secretary 域 的 值 一 一 新 对 象 (序列 #11) 
已 有 的 类 (使 用 序列 #4) 

salary 域 的 值 一 一 double 

hireDate 域 的 值 一 一 新 对 象 ( 序 列 #12) 
已 有 的 类 (使 用 序列 #8) 

外 部 存储 、 字 节 的 数量 

日 期 

结束 标记 

name 域 的 值 一 一 String (序列 #13) 
staff[1] 一 一 已 有 的 对 象 ( 使 用 序列 #11) 
staff[2] 一 一 新 对 象 (序列 #14) 

已 有 的 类 (使 用 序列 #2) 

salary 域 的 值 一 一 double 

hireDay 域 的 值 一 一 新 对 象 (序列 #15) 
已 有 的 类 (使 用 序列 #8) 

外 部 存储 、 字 节 的 数量 

日 期 

结束 标记 

name 域 的 值 一 一 String (序列 #16) 
secretary 域 的 值 一 一 已 有 的 对 象 ( 使 用 序列 #11) 


当然 ， 研 究 这 些 编码 大 概 与 阅读 常用 的 电话 号 码 短 一 样 枯燥 。 了 解 确切 的 文件 格式 确实 
不 那么 重要 (除非 你 试图 通过 修改 数据 来 达到 不 可 告 人 的 目的 )， 但 是 对 象 流 对 其 所 包含 的 所 
有 对 象 都 有 详细 描述 ， 并 且 这 些 充 足 的 细节 可 以 用 来 重 构 对 象 和 对 象 数 组 ， 因 此 了 解 它 还 是 


你 应 该 记 住 : 


e 对 象 流 输 出 中 包含 所 有 对 象 的 类 型 和 数据 域 。 
© 每 个 对 象 都 被 赋予 一 个 序列 号 。 
o 相同 对 象 的 重复 出 现 将 被 存储 为 对 这 个 对 象 的 序列 号 的 引用 。 


2.4.3 ”修改 默认 的 序列 化 机 制 


某 些 数据 域 是 不 可 以 序列 化 的 ， 例如， 只 对 本 地 方法 有 意义 的 存储 文件 句柄 或 窗口 句柄 
的 整数 值 ， 这 种 信息 在 稍 后 重新 加 载 对 象 或 将 其 传送 到 其 他 机 器 上 时 都 是 没有 用 处 的 。 事 实 
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上 ， 这 种 域 的 值 如 果 不 恰 当 ， 还 会 引起 本 地 方法 崩 演 。Java 拥有 一 种 很 简单 的 机 制 来 防止 这 
种 域 被 序列 化 ， 那 就 是 将 它们 标记 成 是 transient 的 。 如 果 这 些 域 属于 不 可 序列 化 的 类 ， 
你 也 需要 将 它们 标记 成 transient 的 。 瞬 时 的 域 在 对 象 被 序列 化 时 总 是 被 跳 过 的 。 

序列 化 机 制 为 单个 的 类 提供 了 一 种 方式 ， 去 向 默认 的 读 写 行为 添加 验证 或 任何 其 他 想 要 
的 行为 。 可 序列 化 的 类 可 以 定义 具有 下 列 签名 的 方法 : 


private void readObject (ObjectInputStream in) 
throws IOException, ClassNotFoundException; 

private void writeObject(ObjectOutputStream out) 
throws IOException; 


之 后 ， 数 据 域 就 再 也 不 会 被 自动 序列 化 ， 取 而 代 之 的 是 调用 这 些 方 法 。 

下 面 是 一 个 典型 的 示例 。 在 java.awt.geom 包 中 有 大 量 的 类 都 是 不 可 序列 化 的 ， 例 如 
Point2D.Double。 现 在 假设 你 想 要 序列 化 一 个 LabeledPoint 类 ， 它 存储 了 一 个 String 
和 一 个 Point2D.Double。 首 先 ， 你 需要 将 Point2D.Double 标记 成 transient， 以 避免 
fit}; NotSerializableException, 

public class LabeledPoint implements Serializable 

private String label; 
private transient Point2D.Double point; 

‘8-4 

在 writeObject 方法 中 ， 我们 首先 通过 调用 defaultWrite0bject 方法 写 出 对 象 描述 
FA String bk 1abe1， 这 是 0bjectoutputSstream 类 中 的 一 个 特殊 的 方法 ， 它 只 能 在 可 
序列 化 类 的 writeObject 方法 中 被 调用 。 然 后 ， 我 们 使 用 标准 的 Data0utput 调用 写 出 点 
的 坐标 。 


private void writeObject(ObjectOutputStream out) 
throws IOException 

{ 
out.defaultWritedbject() ; 
out .writeDouble(point.getX()) ; 
out.writeDouble(point.getY()); 

} 


在 readObject 方法 中 ， 我 们 反 过 来 执行 上 述 过 程 : 


private void read0bject(0bjectInputStream in) 
throws IOException 


{ 
in. defaul tReadObject() ; 
double x = in.readDouble(); 
double y = in. readDouble() ; 
point = new Point2D.Double(x, y); 


} 
男 一 个 例子 是 java.util.Date, ERE ST ACA readObject 和 write0bject 方 
法 ， 这 些 方 法 将 日 期 写 出 为 从 纪元 (UTC 时 间 1970 年 1 月 1 日 0 点 ) 开始 的 毫秒 数 。Date 
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类 有 一 个 复杂 的 内 部 表示 ， 为 了 优化 查询 ， 它 存储 了 一 个 Calendar 对 象 和 一 个 毫秒 计数 
值 。Calendar 的 状态 是 见 余 的 ， 因 此 并 不 需要 保存 。 

readObject fil writeObject 方法 只 需要 保存 和 加 载 它们 的 数据 域 ， 而 不 需要 关心 超 
类 数据 和 任何 其 他 类 的 信息 。 

除了 让 序列 化 机 制 来 保存 和 恢复 对 象 数 据 ， 类 还 可 以 定义 它 自己 的 机 制 。 为 了 做 到 这 一 
点 ， 这 个 类 必须 实现 Externalizable 接口 ， 这 需要 它 定 义 两 个 方法 : 


public void readExternal (ObjectInputStream in) 
throws IOException, ClassNotFoundException; 

public void writeExternal (ObjectOutputStream out) 
throws IOException; 


与 前 面 一 节 描 述 的 readObject Ail writeObject 不 同 ， 这 些 方法 对 包括 超 类 数据 在 内 
的 整个 对 象 的 存储 和 恢复 负 全 责 。 在 写 出 对 象 时 ， 序 列 化 机 制 在 输出 流 中 仅仅 只 是 记录 该 对 
象 所 属 的 类 。 在 读 和 人 可 外 部 化 的 类 时 ， 对 象 输入 流 将 用 无 参 构造 器 创建 一 个 对 象 ， 然 后 调用 
readExternal 方法 。 下 面 展 示 了 如 何 为 Emp1oyee 类 实现 这 些 方法 : 


public void readExternal(0bjectInput s) 
throws IOException 


name = s,readUTF(); 
salary = s.readDouble(); 
hireDay = LocalDate.ofEpochDay(s.readLong()) ; 


public void writeExternal (ObjectOutput s) 
throws IOException 


S.writeUTF (name) ; 

s.writeDouble(salary) ; 

s.writeLong (hi reDay. toEpochDay()) ; 
} 


Q 警告 : readObject 和 writeObject 方法 是 私有 的 ， 并 且 只 能 被 序列 化 机 制 调用 。 与 此 
不 同 的 是 ，readExternal 和 writeExternal 方法 是 公共 的 。 特 别 是 ，readExternal 
还 潜在 地 允许 修改 现 有 对 象 的 状态 。 


2.4.4 序列 化 单 例 和 类 型 安全 的 枚 举 


在 序列 化 和 反 序列 化 时 ， 如 果 目 标 对 象 是 唯一 的 ， 那 么 你 必须 加 信 当 心 ， 这 通常 会 在 实 
现 单 例 和 类 型 安全 的 枚 举 时 发 生 。 

如 果 你 使 用 Java 语言 的 enum 结构， 那么 你 就 不 必 担 心 序列 化 ， 它 能 够 正常 工作 。 但 
是 ,假设 你 在 维护 遗留 代码 ， 其 中 包含 下 面 这 样 的 枚 举 类 型 . 


public class Orientation 


{ 
public static final Orientation HORIZONTAL = new Orientation(1) ; 


public static final Orientation VERTICAL = new Orientation(2); 


| 华章 IT 
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private int value; 


private Orientation(int v) { value = v; } 


这 种 风格 在 枚 举 被 添加 到 Java 语言 中 之 前 是 很 普遍 的 。 注 意 ， 其 构造 器 是 私有 的 。 因 
此 ， 不 可 能 创建 出 超出 orientation.HORIZONTAL 和 Orientation.VERTICAL 之 外 的 对 
象 。 特别 是 ， 你 可 以 使 用 == 操作 符 来 测试 对 象 的 等 同性 : 

if (orientation == Orientation. HORIZONTAL) ，，， 

当 类 型 安全 的 枚 举 实现 Serializable 接口 时 ， 你 必须 牢记 存在 着 一 种 重要 的 变化 ， 此 
时 ， 默 认 的 序列 化 机 制 是 不 适用 的 。 假 设 我 们 写 出 一 个 0rientation 类 型 的 值 ， 并 再 次 将 
其 读 回 : 


Orientation original = Orientation. HORIZONTAL; 
ObjectOutputStream out = . . .; 
out.write(original); 

out.close(); 

ObjectInputStream in =.. 

Orientation saved = EEA in. read(); 


现在 ， 下 面 的 测试 : 
if (saved == Orientation. HORIZONTAL) ，，， 


AIL, EFKE, saved 的 值 是 Orientation 类 型 的 一 个 全 新 的 对 象 ， 它 与 任何 预定 义 的 
并 量 都 不 等 同 。 即 使 构造 器 是 私有 的 ， 序 列 化 机 制 也 可 以 创建 新 的 对 象 ! 

为 了 解决 这 个 问题 ， 你 需要 定义 另外 一 种 称 为 readResolve 的 特殊 序列 化 方法 。 如 果 
定义 了 readResolve 方法， 在 对 象 被 序列 化 之 后 就 会 调用 它 。 它 必须 返回 一 个 对 象 ， 而 
该 对 象 之 后 会 成 为 read0bject 的 返回 值 。 在 上 面 的 情况 中 ,readResolve 方 法 将 检查 
value 域 并 返回 恰当 的 枚 举 常量 . 


protected Object readResolve() throws ObjectStreamException 


{ 
if (value == 1) return Orientation. HORIZONTAL; 
if (value == 2) return Orientation. VERTICAL; 
throw new ObjectStreamException(); // this shouldn't happen 


请 记 住 向 遗留 代码 中 所 有 类 型 安全 的 枚 举 以 及 向 所 有 支持 单 例 设计 模式 的 类 中 添加 
readResolve 方法 。 


2.4.5 ”版 本 管理 


如 条 使 用 序列 化 来 保存 对 象 ， 就 需要 考虑 在 程序 演化 时 会 有 什么 问题 。 例 如 ，1.1 版 本 
可 以 读 入 旧 文 件 吗 ? 仍旧 使 用 1.0 版 本 的 用 户 可 以 读 和 人 新 版 本 产生 的 文件 吗 ? 显然 ， 如 果 对 
象 文件 可 以 处 理 类 的 演化 问题 ， 那 它 正 是 我 们 想 要 的 。 

乍 一 看 ， 这 好 像 是 不 可 能 的 。 无 论 类 的 定义 产生 了 什么 样 的 变化 ， 它 的 SHA 指纹 也 会 
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对 其 早期 版 本 保持 兼容 ， 要 想 这 样 做 ， 就 必须 首先 获得 这 个 类 的 早期 版 本 的 指纹 。 我 们 可 以 
使 用 JDK 中 的 单机 程序 serialver 来 获得 这 个 数字 ， 例 如， 运行 下 面 的 命令 

serialver Employee 

将 会 打印 出 

Employee: static final long serialVersionUID = -1814239825517340645L; 

如 果 在 运行 serialver 程序 时 添加 -show 选项 ， 那 么 这 个 程序 就 会 产生 下 面 的 图 形 化 
对 话 框 (参见 图 2-7 )。 





ee gs AS hea hie 


图 2-7 serialver 程序 的 图 形 化 版 本 


这 个 类 的 所 有 较 新 的 版 本 都 必须 把 serialVersionUID 常量 定义 为 与 最 初版 本 的 指纹 
相同 。 


class Employee implements Serializable // version 1.1 


public static final long serialVersionUID = -1814239825517340645L; 
} 


如 果 一 个 类 具有 名 为 serialVersionUID 的 静态 数据 成 员 ， 它 就 不 再 需要 人 工地 计算 
其 指纹 ， 而 只 需 直 接 使 用 这 个 值 。 

一 日 这 个 静态 数据 成 员 被 置 于 某 个 类 的 内 部 ， 那 么 序列 化 系统 就 可 以 读 人 这 个 类 的 对 象 
的 不 同 版 本 。 

如 果 这 个 类 只 有 方法 产生 了 变化 ， 那 么 在 读 人 新 对 象 数据 时 是 不 会 有 任何 问题 的 。 但 
是 ， 如 果 数 据 域 产生 了 变化 ， 那 么 就 可 能 会 有 问题 。 例 如 ， 旧 文件 对 象 可 能 比 程序 中 的 对 象 
具有 更 多 或 更 少 的 数据 域 ， 或 者 数据 域 的 类 型 可 能 有 所 不 同 。 在 这 些 情况 中 ， 对 象 输入 流 将 
尽力 将 流 对 象 转换 成 这 个 类 当前 的 版 本 。 

对 象 输入 流 会 将 这 个 类 当前 版 本 的 数据 域 与 被 序列 化 的 版 本 中 的 数据 域 进行 比较 ， 当 然 ， 
对 象 流 只 会 考虑 非 瞬 时 和 非 静 态 的 数据 域 。 如 果 这 两 部 分 数据 域 之 间 名 字 匹 配 而 类 型 不 匹配 ， 
那么 对 象 输入 流 不 会 尝试 将 一 种 类 型 转换 成 另 一 种 类 型 ， 因 为 这 两 个 对 象 不 兼容 ; 如 果 被 序列 
化 的 对 象 具 有 在 当前 版 本 中 所 没有 的 数据 域 ， 那 么 对 象 输入 流 会 忽略 这 些 额 外 的 数据 ; 如 末 当 
前 版 本 具有 在 被 序列 化 的 对 象 中 所 没有 的 数据 域 ， 那 么 这 些 新 添加 的 域 将 被 设置 成 它们 的 默认 
值 (如 果 是 对 象 则 是 nu11， 如 果 是 数字 则 为 0， 如 果 是 boolean 值 则 是 false). 

下 面 是 一 个 示例 : 假设 我 们 已 经 用 雇员 类 的 最 初版 本 (1.0) 在 磁盘 上 保存 了 大 量 的 雇 
员 记录 ， 现 在 我 们 在 Employee 类 中 添加 了 称 为 department 的 数据 域 ， 从 而 将 其 演化 到 


/ 
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了 2.0 版 本 。 图 2-8 展示 了 将 1.0 版 的 对 象 读 入 到 使 用 2.0 版 对 象 的 程序 中 的 情形 ， 可 以 看 到 
department 域 被 设置 成 了 null, Bl 2-9 展示 了 相反 的 情况 : 一 个 使 用 1.0 版 对 象 的 程序 读 
AT 2.0 版 的 对 象 ， 可 以 看 到 额外 的 department 域 被 忽略 。 
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图 2-9 读 和 具有 较 多 数据 域 的 对 象 


这 种 处 理 是 安全 的 吗 ? 视 情 况 而 定 。 丢 掉 数 据 域 看 起 来 是 无 害 的 ， 因 为 接收 者 仍旧 拥有 
它 知 道 如 何 处 理 的 所 有 数据 ， 但 是 将 数据 域 设置 为 nu11 却 有 可 能 并 不 那么 安全 。 许 多 类 都 
费 尽 心思 地 在 其 所 有 的 构造 器 中 将 所 有 的 数据 域 都 初始 化 为 非 nu11 的 值 ， 以 使 得 其 各 个 方 
法 都 不 必 去 处 理 null 数据 。 因 此 ， 这 个 问题 取决 于 类 的 设计 者 是 否 能 够 在 read0bject 方 
法 中 实现 额外 的 代码 去 订正 版 本 不 兼容 问题 ， 或 者 是 否 能 够 确保 所 有 的 方法 在 处 理 nu11 数 
据 时 都 足够 健壮 。 


2.4.6 ”为 克隆 使 用 序列 化 
序列 化 机 制 有 一 种 很 有 趣 的 用 法 : 即 提供 了 一 种 克隆 对 象 的 简便 途径 ， 只 要 对 应 的 类 是 
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可 序列 化 的 即 可 。 其 做 法 很 简单 : 直接 将 对 象 序列 化 到 输出 流 中 ， 然 后 将 其 读 回 。 这 样 产 生 
的 新 对 象 是 对 现 有 对 象 的 一 个 深 找 贝 (deep copy)。 在 此 过 程 中 ， 我 们 不 必 将 对 象 写 出 到 文 
件 中 ， 因 为 可 以 用 ByteArrayOutputStream 将 数据 保存 到 字 市 数组 中 。 

正如 程序 清单 2-4 所 示 ， 要 想得到 clone 方法 ， 只 需 扩 展 SerialCloneable 类 ,这样 
就 完事 了 。 


package serialClone; 


/** 
* @ersion 1.21 13 Jul 2016 
* @author Cay Horstmann 


*} 


import java.i0.*; 
import java.util.*; 
10 import java.time.*; 


AD o ~ Oo N Se Ww N + 


12 public class SerialCloneTest 


B { 

14 public static void main(String[] args) throws CloneNotSupportedException 
15 { 

16 Employee harry = new Employee("Harry Hacker", 35000, 1989, 10, 1); 
17 // clone harry 

18 Employee harry2 = (Employee) harry.clone(); 

19 

20 // mutate harry 

21 harry. raiseSalary (10); 

22 

23 // now harry and the clone are different 

24 System.out.println (harry); 

25 System. out. println(harry2) ; 

26 } 

27} 

28 

29 /** 

30 * A class whose clone method uses serialization. 

31 */ 


32 Class SerialCloneable implements Cloneable, Serializable 


{ 
34 public Object clone() throws CloneNotSupportedException 


35 { 

36 try { 

37 // save the object to a byte array 

38 ByteArrayOutputStream bout = new ByteArrayOutputStream() ; 
39 try (ObjectOutputStream out = new ObjectOutputStream(bout)) 
40 { 

41 out.writeObject (this) ; 

42 } 

43 

44 // read a clone of the object from the byte array 
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45 try (InputStream bin = new ByteArrayInputStream(bout.toByteArray())) 
46 { 

47 ObjectInputStream in = new ObjectInputStream(bin) ; 

48 return in. readObject(); 

49 } 

50 

51 catch (IOException | ClassNotFoundException e) 

52 

53 CloneNotSupportedException e2 = new CloneNotSupportedException(); 
54 e2.initCause(e) ; 

55 throw e2; 

56 } 

57 } 

58 } 

59 

60 /** 


61 * The familiar Employee class, redefined to extend the 
62 * SerialCloneable class. 

63 */ 

64 Class Employee extends SerialCloneable 

6 { 

66 private String name; 

67 private double salary; 

68 private LocalDate hireDay; 


70 public Employee(String n, double s, int year, int month, int day) 


7 name = n; 
23 Salary = S; 

74 hireDay = LocalDate.of(year, month, day); 
75 } 


77 public String getName() 


79 return name; 

80 } 

81 

82 public double getSalary() 

83 { 

84 return salary; 

85 } 

86 

87 public LocalDate getHireDay() 

88 { 

89 return hireDay; 

90 } 

91 

92 /** 

93 * Raises the salary of this employee. 
94 * @byPercent the percentage of the raise 
95 */ 


96 public void raiseSalary(double byPercent) 


98 double raise = salary * byPercent / 100; 
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99 Salary += raise; 


102 public String toString() 


{ 
104 return getClass() .getName() 


105 + "[name=" + name 

106 + "\salary=" + salary 

107 + "hireDay=" + hireDay 
wou, 


108 + "| 
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隆 数据 域 的 克隆 方法 慢 得 多 。 


2.5 ”操作 文件 


你 已 经 学 习 了 如 何 从 文件 中 读 写 数据 ， 然 而 文件 管理 的 内 涵 远 远 比 读 写 要 广 。Path 和 
Files 类 封装 了 在 用 户 机 器 上 处 理 文件 系统 所 需 的 所 有 功能 。 例 如 ，Files 类 可 以 用 来 移 除 
或 重 命名 文件 ， 或 者 查询 文件 最 后 被 修改 的 时 间 。 换 句 话 说 ,输入 /输出 流 类 关心 的 是 文件 
的 内 容 ， 而 我 们 在 此 处 要 讨论 的 类 关心 的 是 在 磁盘 上 如 何 存储 文件 。 

Path 接口 和 Files 类 是 在 Java SE 7 中 新 添加 进来 的 ， 它 们 用 起 来 比 自 JDK 1.0 以 来 就 
一 直 使 用 的 File 类 要 方便 得 多 。 我 们 认为 这 两 个 类 会 在 Java 程序 员 中 流行 起 来 ， 因 此 在 这 
里 做 深度 讨论 。 


2.5.1 Path 


Path 表示 的 是 一 个 目录 名 序列 ， 其 后 还 可 以 跟着 一 个 文件 名 。 路 径 中 的 第 一 个 部 件 可 
以 是 根部 件 ， 例 如 /或 C\， 而 允许 访问 的 根部 件 取决 于 文件 系统 。 以 根部 件 开始 的 路 径 是 缀 
对 路 径 ; 否则 ， 就 是 相对 路 径 。 例 如 ， 我 们 要 分 别 创建 一 个 绝对 路 径 和 一 个 相对 路 径 ; 其 中 ， 
对 于 绝对 路 径 ， 我 们 假设 计算 机 运行 的 是 类 Unix 的 文件 系统 : 


Path absolute = Paths.get("/home", "harry ) 
Path relative = Paths.get("myprog", "conf", "user.properties"); 


静态 的 Paths .get 方法 接受 一 个 或 多 个 字符 串 ， 并 将 它们 用 默认 文件 系统 的 路 径 分 陋 
符 (类 Unix 文件 系统 是 /，Windows 是 \) 连接 起 来 。 然 后 它 解析 连接 起 来 的 结果 ， 如 果 其 表 
示 的 不 是 给 定 文件 系统 中 的 合法 路 径 ， 那 么 就 抛 出 InvalidPathException 异常 。 这 个 连 
接 起 来 的 结果 就 是 一 个 Path 对 象 。 

get 方法 可 以 获取 包含 多 个 部 件 构成 的 单个 字符 串 ， 例 如 ， 可 以 像 下 面 这 样 从 配置 文件 
中 读 取 路 径 : 


j 
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String baseDir = props.getProperty("base.dir"); 
// May be a string such as /opt/myprog or c:\Program Files\myprog 
Path basePath = Paths.get(baseDir); // OK that baseDir has separators 


注意 : 路 径 不 必 对 应 着 某 个 实际 存在 的 文件 ， 它 仅仅 只 是 一 个 抽象 的 名 字 序 列 。 你 在 接 
下 来 的 小 节 中 将 要 看 到 ， 当 你 想 要 创建 文件 时 ， 首 先 要 创建 一 个 路 径 ， 然 后 才 调 用 方法 
去 创建 对 应 的 文件 。 


组 合 或 解析 路 径 是 司空 见 惯 的 操作 ， 调 用 p.resolve(9q) 将 按照 下 列 规则 返回 一 个 路 径 ; 

o 如 来 q 是 绝对 路 径 ， 则 绪 末 就 是 q。 

e 和 否则， 根据 文件 系统 的 规则 ， 将 “p 后 面 跟着 q” 作 为 结果 。 

例如 ， 假 设 你 的 应 用 系统 需要 查找 相对 于 给 定 基 目 录 的 工作 目录 ， 其 中 基 目 录 是 从 配置 
文件 中 读 取 的 ， 就 像 前 一 个 例子 一 样 。 


Path workRelative = Paths.get("work"); 
Path workPath = basePath. resolve(workRelative) ; 


resolve 方法 有 一 种 快捷 方式 ， 它 接受 一 个 字符 串 而 不 是 路 径 : 

Path workPath = basePath. resolve("work"); 

还 有 一 个 很 方便 的 方法 resolveSib1ing， 它 通过 解析 指定 路 径 的 父 路 径 产 生 其 兄弟 路 
径 。 例如， 如 果 workPath 是 /opt/myapp/work, 那么 下 面 的 调用 

Path tempPath = workPath.resolveSibling("temp") ; 
将 创建 /opt/myapp/temp。 

resolve 的 对 立 面 是 relativize， 即 调用 p.relativizeCr ) 将 产生 路 径 q9， 而 对 q 
进行 解析 的 结果 正 是 r。 例 如， 以 “/home/cay” 为 目标 对 “ /home/fred/myprog” 进 行 
相对 化 操作 ， 会 产生 “. ./fred/myprog”， 其 中 ,我 们 假设 .. 表示 文件 系统 中 的 父 目 录 。 

normalize 方法 将 移 除 所 有 元 余 的 . 和 .… 部 件 (或 者 文件 系统 认为 元 余 的 所 有 部 件 )。 例 
如 ， 规 范 化 /home/cay/../fred/./myprog 将 产生 /home/fred/myprog。 

toAbsolutePath 方法 将 产生 给 定 路 径 的 绝对 路 径 ， 该 绝对 路 径 从 根部 件 开始 ， 例 如 / 
home/fred/input.txt ak c:\Users\fred\input. txt, 

Path 类 有 许多 有 用 的 方法 用 来 将 路 径 断 开 。 下 面 的 代码 示例 展示 了 其 中 部 分 最 有 用 的 
方法 : 

Path p = Paths.get("/home", "fred", "myprog.properties"); 

Path parent = p.getParent(); // the path /home/fred 


Path file = p.getFileName(); // the path myprog.properties 
Path root = p.getRoot(); // the path / 


正如 你 已 经 在 卷 [ 中 看 到 的 ， 还 可 以 从 Path 对 象 中 构建 Scanner WE: 


Scanner in = new Scanner(Paths.get("/home/fred/input.txt")); 


注意 : 偶尔 ， 你 可 能 需要 与 遗留 系统 的 API 交互 ， 它 们 使 用 的 是 File 类 而 不 是 Path 接 
口 。Path 接口 有 一 个 toFile 方法， 而 File 类 有 一 个 toPath 方法 。 
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e static Path get(String first, String... more) 
通过 连接 给 定 的 字符 串 创建 一 个 路 径 。 








e Path resolve(Path other) 

e Path resolve(String other) 
如 果 other 是 绝对 路 径 ， 那 么 就 返回 other; 否则 ， 返 回 通过 连接 this 和 other 获 
得 的 路 径 。 

e Path resolveSibling(Path other ) 

e Path resolveSibling(String other) 

如 果 other 是 绝对 路 径 ， 那 么 就 返回 other; 否则 ， 返 回 通 过 连接 this 的 父 路 径 和 
other 获得 的 路 径 。 

e Path relativize(Path other) 
返回 用 this 进行 解析 ， 相 对 于 other 的 相对 路 径 。 

e Path normalize() 

移 除 诸如 . Al . 等 元 余 的 路 径 元 素 。 

e Path toAbsolutePath() 
返回 与 该 路 径 等 价 的 绝对 路 径 。 

e Path getParent() 
返回 父 路 径 ， 或 者 在 该 路 径 没 有 父 路 径 时 ， 返 回 null, 

e Path getFileName() 
返回 该 路 径 的 最 后 一 个 部 件 ， 或 者 在 该 路 径 没 有 任何 部 件 时 ， 返 回 nu11。 

e Path getRoot() 
返回 该 路 径 的 根部 件 ， 或 者 在 该 路 径 没 有 任何 根部 件 时 ， 返 回 nu11。 

e toFile() 

从 该 路 径 中 创建 一 个 File 对 象 。 





e Path toPath() 7 
从 该 文件 中 创建 一 个 Path 对 象 。 
25.2 ” 读 写 文件 


Files 类 可 以 使 得 普通 文件 操作 变 得 快捷 。 例 如 ， 可 以 用 下 面 的 方式 很 容易 地 读 取 文件 
的 所 有 内 容 : 


byte[] bytes = Files.readAllBytes(path); 
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如 果 想 将 文件 当 作 字 符 串 读 人 ， 那 么 可 以 在 调用 readA11Bytes 之 后 执行 下 面 的 代码 : 
String content = new String(bytes, charset) ; 
但 是 如 果 和 希望 将 文件 当 作 行 序列 恋人 ， 那 么 可 以 调用 : 
List<String> lines = Files.readAllLines(path, charset); 
相反 地 ， 如 果 和 希望 写 出 一 个 字符 串 到 文件 中 ， 可 以 调用 : 
Files.write(path, content.getBytes(charset)) ; 
向 指定 文件 追加 内 容 ， 可 以 调用 : 
Files.write(path, content.getBytes(charset), StandardOpenOption. APPEND) ; 
还 可 以 用 下 面 的 语句 将 一 个 行 的 集合 写 出 到 文件 中 : 
Files.write(path, lines); 


这 些 简 便 方 法 适用 于 处 理 中 等 长 度 的 文本 文件 ， 如 果 要 处 理 的 文件 长 度 比较 大 ， 或 者 是 二 进 
制 文 件 ， 那 么 还 是 应 该 使 用 所 熟知 的 输入 /输出 流 或 者 谈 人 融 / T Ha: 


InputStream in = Files.newInputStream(path) ; 
OutputStream out = Files.newOutputStream(path) ; 
Reader in = Files.newBufferedReader(path, charset); 
Writer out = Files.newBufferedWriter(path, charset); 


这 些 便捷 方法 可 以 将 你 从 处 理 FileInputStream, File0utputStream BufferedReader 
和 BufferedWriter 的 繁复 操作 中 解脱 出 来 。 





e static byte[] readAllBytes(Path path) 
e static List<String> readAllLines(Path path, Charset charset) 
谈 入 文件 的 内 容 。 
e static Path write(Path path, byte[] contents, OpenOption... options) 
e static Path write(Path path, Iterable<? extends CharSequence> 


contents, OpenOption options) 
将 给 定 内 容 写 出 到 文件 中 ， 并 返回 path, 
e static InputStream newInputStream(Path path, OpenOption... options) 
estatic OutputStream newOutputStream(Path path, OpenOption... 
options) 
e static BufferedReader newBufferedReader(Path path, Charset charset) 
e static BufferedWriter newBufferedWriter(Path path, Charset charset, 
OpenOption... options) 
打开 一 个 文件 ， 用 于 恋人 或 与 出 。 
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2.5.3 创建 文件 和 目录 
创建 新 目录 可 以 调用 


Files,CreateDirectory(path) ; 


其 中 ， 路 径 中 除 最 后 一 个 部 件 外 ， 其 他 部 分 都 必须 是 已 存在 的 。 要 创建 路 径 中 的 中 间 目 录 ， 
应 该 使 用 


Files.createDirectories (path); 
可 以 使 用 下 面 的 语句 创建 一 个 空 文件 : 


Files.createFile(path) ; 


如 果 文 件 已 经 存在 了 ， 那 么 这 个 调用 就 会 抛 出 异常 。 检 查 文件 是 否 存在 和 创建 文件 是 原子 性 的 ， 
如 果 文 件 不 存在 ， 该 文件 就 会 被 创建 ， 并 且 其 他 程序 在 此 过 程 中 是 无 法 执行 文件 创建 操作 的 。 
有 些 便捷 方法 可 以 用 来 在 给 定位 置 或 者 系统 指定 位 置 创建 临时 文件 或 临时 目录 : 


Path newPath = Files.createTempFile(dir, prefix, suffix); 
Path newPath = Files.createTempFile(prefix, suffix); 
Path newPath = Files.createTempDirectory(dir, prefix); 
Path newPath = Files.createTempDi rectory (prefix); 


Hp, dir 是 一 个 Path 对 象 ，prefix 和 suffix 是 可 以 为 nu11 的 字符 串 。 例 如 ， 调 用 
Files.createTempFile(null, “ .txt”) 可 能 会 返回 一 个 像 /tmp/1234405522364837194. 
txt 这 样 的 路 径 。 

在 创建 文件 或 目录 时 ， 可 以 指定 属性 ， 例 如 文件 的 拥有 者 和 权限 。 但 是 ， 指 定 属性 的 细 
节 取 决 于 文件 系统 ， 本 书 在 此 不 做 讨论 。 
站 a 
e static Path createFile(Path path, FileAttribute<?>... attrs) 
e static Path createDirectory(Path path, FileAttribute<?>... attrs) 

e static Path createDirectories(Path path, FileAttribute<?>... attrs) 
创建 一 个 文件 或 目录 ，createDirectories 方法 还 会 创建 路 径 中 所 有 的 中 间 目 录 。 

estatic Path createTempFile(String prefix, String suffix, 
FileAttribute<?>... attrs) 

estatic Path createTempFile(Path parentDir, String prefix, String 
suffix, FileAttribute<?>... attrs) 

e static Path createTempDirectory(String prefix, FileAttribute<?>... attrs) 








estatic Path createTempDirectory(Path parentDir, String prefix, 
FileAttribute<?>... attrs) 
在 适合 临时 文件 的 位 置 ， 或 者 在 给 定 的 父 目 录 中 ， 创 建 一 个 临时 文件 或 目录 。 返 回 所 
创建 的 文件 或 目录 的 路 径 。 


HAIT 
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2.5.4 复制、 移动 和 删除 文件 
将 文件 从 一 个 位 置 复制 到 另 一 个 位 置 可 以 直接 调用 


Files.copy(fromPath, toPath); 

移动 文件 ( 即 复制 并 删除 原文 件 ) 可 以 调用 

Files.move(fromPath, toPath) ; 

如 有 果 目 标 路 径 已 经 存在 ， 那 么 复制 或 移动 将 失败 。 如 果 想 要 覆盖 已 有 的 目标 路 径 ， 
可 以 使 用 REPLACE_EXISTING 选项 。 如 果 想 要 复制 所 有 的 文件 属性 ， 可 以 使 用 COPY_ 
ATTRIBUTES 选项 。 也 可 以 像 下 面 这 样 同时 选择 这 两 个 选项 : 


Files.copy(fromPath, toPath, StandardCopyOption.REPLACE_EXISTING, 
StandardCopyOption.COPY_ATTRIBUTES) ; 


你 可 以 将 移动 操作 定义 为 原子 性 的 ， 这 样 就 可 以 保证 要 么 移动 操作 成 功 完成 ， 要 么 源 文 
件 继续 保持 在 原来 位 置 。 具 体 可 以 使 用 ATOMIC_MOVE 选项 来 实现 : 

Files.move(fromPath, toPath, StandardCopyOption.ATOMIC_MOVE) ; 

你 还 可 以 将 一 个 输入 流 复制 到 Path 中 ， 这 表示 你 想 要 将 该 输入 流 存 储 到 硬盘 上 。 类 似 
地 ， 你 可 以 将 一 个 Path 复制 到 输出 流 中 。 可 以 使 用 下 面 的 调用 : 


Files.copy(inputStream, toPath) ; 
Files.copy(fromPath, outputStream) ; 


至 于 其 他 对 copy 的 调用 ， 可 以 根据 需要 提供 相应 的 复制 选项 。 
最 后 ， 删 除 文件 可 以 调用 : 
Files.delete(path) ; 
如 果 要 删除 的 文件 不 存在 ， 这 个 方法 就 会 抛 出 异常 。 因 此 ， 可 转 而 使 用 下 面 的 方法 : 
boolean deleted = Files.deleteIfExists(path); 
该 删除 方法 还 可 以 用 来 移 除 空 目录 。 
请 查阅 表 2-3 以 了 解 对 文件 操作 而 言 可 用 的 选项 。 
表 2-3 用 于 文件 操作 的 标准 选项 


z WW fa $ 
StandardOpenOption; 与 newBufferedWriter, newInputStream, newOutputStream, write 一 起 使 用 
READ 用 于 读 取 而 打开 


WRITE 用 于 写 人 而 打开 

APPEND 如 果 用 于 写 入 而 打开 ， 那 么 在 文件 末尾 追加 
TRUNCATE_EXISTING 如 果 用 于 写 人 而 打开 ， 那 么 移 除 已 有 内 容 
CREATE_NEW 创建 新 文件 并 且 在 文件 已 存在 的 情况 下 会 创建 失败 
CREATE 自动 在 文件 不 存在 的 情况 下 创建 新 文件 
DELETE_ON_CLOSE 当 文件 被 关闭 时 ， 尽 “可 能 ”地 删除 该 文件 
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( 续 ) 
选 项 描 $ 
SPARSE 给 文件 系统 一 个 提示 ， 表 示 该 文件 是 稀 朴 的 
DSYN|SYN 要 求 对 文件 数据 | 数据 和 元 数据 的 每 次 更 新 都 必须 同步 地 写 人 到 存储 设备 中 
StandardCopyOption; 与 copy, move 一 起 使 用 
ATOMIC_MOVE 原子 性 地 移动 文件 
COPY_ATTRIBUTES 复制 文件 的 属性 
REPLACE_EXISTING 如 果 目 标 已 存在 ， 则 替换 它 
LinkOption; 与 上 面 所 有 方法 以 及 exists，isDirectory，isRegularFile 等 一 起 使 用 
NOFOLLOW_LINKS 不 要 跟踪 符号 链接 
FileVisitOption; 5j find, walk, walkFileTree 一 起 使 用 
FOLLOW_LINKS 跟踪 符号 链接 





e static Path copy(Path from, Path to, CopyOption... options) 

e static Path move(Path from, Path to, CopyOption... options) 
将 From 复制 或 移动 到 给 定位 置 ， 并 返回 to. 

e static long copy(InputStream from, Path to, CopyOption... options) 

e static long copy(Path from, OutputStream to, CopyOption... options) 
WS ATL HI BISCO PEP, REAR AAP, Td SS ie A 

e static void delete(Path path) 

e static boolean deleteIfExists(Path path) 
删除 给 定 文件 或 空 目录 。 第 一 个 方法 在 文件 或 目录 不 存在 情况 下 抛 出 异常 ， 而 第 二 个 
方法 在 这 种 情况 下 会 返回 false。 


2.5.5 获取 文件 信息 
下 面 的 静态 方法 都 将 返回 一 个 boolean 值 ， 表 示 检 查 路 径 的 某 个 属性 的 结果 : 


eexists 

e isHidden 

èe isReadable, isWritable, isExecutable 

èe isRegularFile, isDirectory, isSymbolicLink 
size FARRIS : 

long fileSize = Files.size(path) ; 


getOwner 方法 将 文件 的 拥有 者 作为 java.nio.file.attribute.UserPrincipal 的 
一 个 实例 返回 。 
所 有 的 文件 系统 都 会 报告 一 个 基本 属性 集 ， 它 们 被 封装 在 BasicFileAttributes 接口 
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H, DRS EAR RA MOS. ACHE ee: 

e 创建 文件 、 最 后 一 次 访问 以 及 最 后 一 次 修改 文件 的 时 间 ， 这 些 时 间 都 表示 成 java. 

nio.file.attribute.FileTime 

o 文件 是 常规 文件 、 目 录 还 是 符号 链接 ， 抑 或 这 三 者 都 不 是 。 

e XIFR T. 

e 文件 主键 ， 这 是 某 种 类 的 对 象 ， 具 体 所 属 类 与 文件 系统 相关 ， 有 可 能 是 文件 的 唯一 标 

识 符 ， 也 可 能 不 是 。 

要 获取 这 些 属性 ， 可 以 调用 

BasicFileAttributes attributes = Files.readAttributes(path, BasicFileAttributes.class) ; 

如 果 你 了 解 到 用 户 的 文件 系统 兼容 POSIX， 那 么 你 可 以 获取 一 个 PosixFileAttributes 
实例 : 

PosixFileAttributes attributes = Files.readAttributes(path, PosixFileAttributes.class); 

然后 从 中 找到 组 拥有 者 ， 以 及 文件 的 拥有 者 、 组 和 访问 权限 。 我 们 不 会 详细 讨论 其 细 
节 ， 因 为 这 种 信息 中 很 多 内 容 在 操作 系统 之 间 并 不 具备 可 移植 性 。 





e static boolean exists(Path path) 

e static boolean isHidden(Path path) 

e static boolean isReadable(Path path) 

e static boolean isWritable(Path path) 

e static boolean isExecutable(Path path) 

e static boolean isRegularFile(Path path) 

e static boolean isDirectory(Path path) 

e static boolean isSymbolicLink(Path path) 
检查 由 路 径 指 定 的 文件 的 给 定 属性 。 

e static long size(Path path) 
获取 文件 按 字 市 数 度量 的 信 寸 。 

eA readAttributes(Path path, Class<A> type, LinkOption... options) 


读 取 类 型 为 A 的 文件 属性 。 





eFileTime creationTime( ) 
eFileTime 1astAccessTime( ) 
eFileTime lastModifiedTime( ) 
e boolean isRegularFile() 


e boolean isDirectory() 
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e boolean isSymbolicLink() 

e long size() 

e Object fileKey() 
获取 所 请 求 的 属性 。 


25.6 ”访问 目录 中 的 项 


静态 的 Files.1ist 方法 会 返回 一 个 可 以 读 取 目录 中 各 个 项 的 Stream<Path> 对 和 象 。 H 
录 是 被 惰性 读 取 的 ， 这 使 得 处 理 具有 大 量 项 的 目录 可 以 变 得 更 高 效 。 
因为 读 取 目录 涉及 需要 关闭 的 系统 资源 ， 所 以 应 该 使 用 try 块 : 


try (Stream<Path> entries = Files.list(pathToDi rectory)) 
{ 


= 
list 方法 不 会 进入 子 目 录 。 为 了 处 理 目录 中 的 所 有 子 目录 ， 需 要 使 用 File.walk 方法 。 


try (Stream<Path> entries = Files.walk(pathToRoot) ) 


// Contains all descendants, visited in depth-first order 


} 
下 面 是 加 压 后 的 src .zip 树 的 遍历 样 例 : 


java 

java/nio 
java/nio/DirectCharBufferu. java 
java/nio/ByteBufferAsShortBufferRL. java 
java/nio/MappedByteBuffer. java 


java/nio/ByteBufferAsDoub] eBufferB. java 
java/nio/charset 

java/nio/charset/CoderMal functionError. java 
java/nio/charset/CharsetDecoder. java 
java/nio/charset/UnsupportedCharsetException. java 
java/nio/charset/spi 
java/nio/charset/spi/CharsetProvider. java 
java/nio/charset/StandardCharsets. java 
java/nio/charset/Charset. java 


java/nio/charset/CoderResult. java 
java/nio/HeapFloatBufferr. java 


正如 你 所 见 ， 无 论 何 时 ， 只 要 遍历 的 项 是 目录 ， 那 么 在 进入 它 之 前 ， 会 继续 访问 它 的 元 
可 以 通过 调用 File.walk(pathToRoot，depth) 来 限制 想 要 访问 的 树 的 深度 。 两 种 


walk 方法 都 具有 Filevisitoption... 的 可 变 长 参数 ,但 是 你 只 能 提供 一 种 选项 : FOLLOW 
LINKS， 即 跟踪 符号 链接 。 


/ 
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注意 : 如 果 要 过 滤 walk 返回 的 路 径 ， 并 且 你 的 过 滤 标 准 涉及 与 目录 存储 相关 的 文件 属 
性 ， 例 如 尺寸 、 创 建 时 间 和 类 型 (H, R, Fit) WA AgM find 方法 
来 替代 walk 方法 。 可 以 用 某 个 谓词 函数 来 调用 这 个 方法 ， 该 函数 接受 一 个 路 径 和 一 个 
BasicFileAttributes 对 象 。 这 样 做 唯一 的 优势 就 是 效率 高 。 因 为 路 径 总 是 会 被 读 入 ， 
所 以 这 些 属 性 很 容易 获取 。 
这 段 代 码 使 用 了 Files.walk 方法 来 将 一 个 目录 复制 到 另 一 个 目录 : 
Files.walk(source).forEach(p -> 


try 
{ 
Path q = target.resolve(source.relativize(p)); 
if (Files.isDirectory(p)) 
Files.createDirectory(q) ; 
else 
Files.copy(p, q); 


catch (IOException ex) 
throw new UncheckedIOException(ex) ; 
p; 
遗憾 的 是 ， 你 无 法 很 容易 地 使 用 Files .walk 方法 来 删除 目录 树 ， 因 为 你 需要 在 删除 父 
目录 之 前 必须 先 删 除 子 目 录 。 下 一 节 将 展示 如 何 克 服 此 问题 。 
2.5.7 ”使 用 目录 流 


正如 在 前 一 节 中 所 看 到 的 ，Files.walk 方法 会 产生 一 个 可 以 遍历 目录 中 所 有 子孙 
的 Stream<Path> 对 象 。 有 时 ， 你 需要 对 遍历 过 程 进行 更 加 细 粒 度 的 控制 。 在 这 种 情况 
下 ， 应 该 使 用 File.newDirectoryStream 对 象 ， 它 会 产生 一 个 DirectoryStream。 注 
意 ， 它 不 是 java.util1.stream.Stream 的 子 接口 ， 而 是 专门 用 于 目录 遍历 的 接口 。 它 
je Iterable 的 子 接口 ， 因 此 你 可 以 在 增强 的 for 循环 中 使 用 目录 流 。 下 面 是 其 使 用 
模式 : 


try (DirectoryStream<Path> entries = Files.newDirectoryStream(dir)) 


for (Path entry : entries) 
Process entries 
} 


try 语句 块 用 来 确保 目录 流 可 以 被 正确 关闭 。 访 问 目录 中 的 项 并 没有 具体 的 顺序 。 
可 以 用 glob 模式 来 过 滤 文 件 : 
try (DirectoryStream<Path> entries = Files.newDirectoryStream(dir, "*.java")) 


表 2-4 展示 了 所 有 的 glob 模式 。 
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表 2-4 Glob 模式 


a aO z 


匹配 路 径 组 成 部 分 中 0 个 或 多 个 字符 *. java 匹配 当前 目录 中 的 所 有 Java 文件 










匹配 跨 目 录 边 界 的 0 个 或 多 个 字符 ** java 匹配 在 所 有 子 目录 中 的 Java 文件 
? 匹配 一 个 字符 22??. java 匹配 所 有 四 个 字符 的 Java 文件 (不 包括 扩展 名 ) 
[...] 匹配 一 个 字符 集合 ， 可 以 使 用 连 线 符 | Test[0-9A-F].java 匹配 Testx.java， 其 中 x 是 一 个 
[0-9] 和 取 反 符 [!0-9] 十 六 进 制 数字 
{...} 匹配 由 逗号 隔 开 的 多 个 可 选项 之 一 *{java,class} 匹配 所 有 的 Java 文件 和 类 class 文件 


转 义 上 述 任意 模式 中 的 字符 以 及 \ 字 符 | *\** 匹配 所 有 文件 名 中 包含 * 的 文件 
@ 警告 如 果 使 用 Windows 的 glob 语法 ， 则 必须 对 反 斜 杠 转 义 两 次 : —KA glob 语法 
转 义 ， 一 次 为 Java 字符 串 转 义 : Files.newDirectoryStream(dir, “C:\\\\” ) 


如 果 想 要 访问 某 个 目录 的 所 有 子孙 成 员 ， 可 以 转 而 调用 walkFileTree 方法 ， 并 向 其 传 
递 一 个 FileVisitor 类 型 的 对 象 ， 这 个 对 象 会 得 到 下 列 通知 : 
e 在 遇 到 一 个 文件 或 目录 时 : FileVisitResult visitFile(T path, BasicFileAttributes 
attrs ) 
e 在 一 个 目录 被 处 理 前 : FileVisitResult preVisitDirectory(T dir, IOException ex) 
e 在 一 个 目录 被 处 理 后 : FileVisitResult postVisitDirectory(T dir, IOException ex) 
e 在 试图 访问 文件 或 目录 时 发 生 错 误 ， 例 如 没有 权限 打开 目录 : FileVisitResult 
visitFileFailed(path, IOException) 
对 于 上 述 每 种 情况 ， 都 可 以 指定 是 否 希 望 执 行 下 面 的 操作 : 
e 继续 访问 下 一 个 文件 : FileVisitResult .CONTINUE 
e 继续 访问 ， 但 是 不 再 访问 这 个 目录 下 的 任何 项 了 : FileVisitResult.SKIP_SUBTREE 
e 继续 访问 ， 但 是 不 再 访问 这 个 文件 的 兄弟 文 (和 该 文件 在 同一 个 目录 下 的 文件 ) T: 
FileVisitResult.SKIP_SIBLINGS 
e 终止 访问 : FileVisitResult. TERMINATE 
当 有 任何 方法 抛 出 异常 时 ， 就 会 终止 访问 ， 而 这 个 异常 会 从 walkFileTree 方法 中 
抛 出 。 


注意 : FileVisitor 接口 是 泛 化 类 型 ， 但 是 你 也 太 可 能 会 使 用 除 FileVisitor<Path> 
之 外 的 东西 。walkFileTree 方法 可 以 接受 FileVisitor<? Super Path> 类 型 的 参数 ， 
但 是 Path 并 没有 多 少 超 类 型 。 
便捷 类 SimpleFileVisitor 实现 了 FileVisitor 接口 ， 但 是 其 除 visitFileFailed 
方法 之 外 的 所 有 方法 并 不 做 任何 处 理 而 是 直接 继续 访问 ， 而 Vis itFileFailed 方法 会 抛 出 由 
失败 导致 的 异常 ， 并 进而 终止 访问 。 
例如 ， 下 面 的 代码 展示 了 如 何 打印 出 给 定 目录 下 的 所 有 子 目 录 : 
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Files.walkFileTree(Paths.get("/"), new SimpleFileVisitor<Path>() 


{ 
public FileVisitResult preVisitDirectory(Path path, BasicFileAttributes attrs) 


throws IOException 
{ 


System.out.print]n(path) ; 
return FileVisitResult. CONTINUE; 


} 


public FileVisitResult postVisitDirectory(Path dir, IOException exc) 


{ 
return FileVisitResult. CONTINUE; 
} 


public FileVisitResult visitFileFailed(Path path, IOException exc) throws IOException 
return FileVisitResult.SKIP_SUBTREE; 
Di 

值得 注意 的 是 ， 我 们 需要 覆盖 postVisitDirectory 方 法 和 visitFileFailed 方法 ， 
否则 ， 访 问 会 在 遇 到 不 允许 打开 的 目录 或 不 允许 访问 的 文件 时 立即 失败 。 

还 应 该 注意 的 是 ， 路 径 的 众多 属性 是 作为 preVisitDirectory 和 visitFile 方 法 的 
参数 传递 的 。 访 问 者 不 得 不 通过 操作 系统 调用 来 获得 这 些 属 性 ， 因 为 它 需要 区 分 文件 和 目 
录 。 因 此 ， 你 就 不 需要 再 次 执行 系统 调用 了 。 

如 果 你 需要 在 进入 或 离开 一 个 目录 时 执行 某 些 操作 ， 那 么 FileVisitor 接口 的 其 他 方 
法 就 显得 非常 有 用 了 。 例 如 ， 在 删除 目录 树 时 ， 需 要 在 移 除 当 前 目录 的 所 有 文件 之 后 ， 才 能 
移 除 该 目录 。 下 面 是 删除 目录 树 的 完整 代码 : 


// Delete the directory tree starting at root 
Files.walkFileTree(root, new SimpleFileVisitor<Path>() 


public FileVisitResult visitFile(Path file, BasicFileAttributes attrs) throws IOException 


{ 
Files.delete(file); 
return FileVisitResult. CONTINUE; 


} 


public FileVisitResult postVisitDirectory(Path dir, IOException e) throws IOException 


if (e != null) throw e; 
Files.delete(dir); 
return FileVisitResult.CONTINUE: 
} 
iy 





yii 





e static DirectoryStream<Path> newDirectoryStream(Path path) 
e static DirectoryStream<Path> newDirectoryStream(Path path, String glob) 
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获取 给 定 目录 中 可 以 遍历 所 有 文件 和 目录 的 迭代 器 。 第 二 个 方法 只 接受 那些 与 给 定 的 
glob 模式 匹配 的 项 。 
estatic Path walkFileTree(Path start, FileVisitor<? super Path> 


visitor) 
孙 ， 


遍历 给 定 路 径 的 所 有 子 


并 将 访问 器 应 用 于 这 些 子孙 之 上 。 










e static FileVisitResult visitFile(T path, BasicFileAttributes attrs) 
在 访问 文件 或 目录 时 被 调用 ， 返 回 CONTINUE, SKIP_SUBTREE, SKIP_SIBLINGS 
Ail TERMINATE 之 一 ， 默 认 实现 是 不 做 任何 操作 而 继续 访问 。 

e static FileVisitResult preVisitDirectory(T dir, BasicFileAttributes attrs ) 

e static FileVisitResult postVisitDirectory(T dir, BasicFileAttributes 
attrs) 

在 访问 目录 之 前 和 之 后 被 调用 ， 默 认 实现 是 不 做 任何 操作 而 继续 访问 。 

estatic FileVisitResult visitFileFailed(T path, IOException exc) 

如 果 在 试图 获取 给 定 文件 的 信息 时 抛 出 异常 ， 则 该 方法 被 调用 。 默 认 实现 是 重新 抛 出 
异常 ， 这 会 导致 访问 操作 以 这 个 异常 而 终止 。 如 果 你 想 自 己 访问 ， 可 以 覆盖 这 个 方法 。 


2.5.8 ZIP 文件 系统 


Paths 类 会 在 默认 文件 系统 中 查找 路 径 ， 即 在 用 户 本 地 磁盘 中 的 文件 。 你 也 可 以 有 别 的 
文件 系统 ， 其 中 最 有 用 的 之 一 是 ZIP 文件 系统 。 如 果 zipname 是 某 个 ZIP 文件 的 名 字 ， 那 
么 下 面 的 调用 

FileSystem fs = FileSystems.newFileSystem(Paths.get(zipname), null); 


将 建立 一 个 文件 系统 ， 它 包含 ZIP 文档 中 的 所 有 文件 。 如 果 知道 文件 名 ,那么 从 ZIP 文档 中 
复制 出 这 个 文件 就 会 变 得 很 容易 : 

Files.copy(fs.getPath(sourceName), targetPath) ; 

其 中 ，fs .getPath 对 于 任意 文件 系统 来 说 ， 都 与 Paths .get 类 似 。 

要 列 出 ZIP 文档 中 的 所 有 文件 ， 可 以 遍历 文件 树 : 

FileSystem fs = FileSystems.newFileSystem(Paths.get(zipname), null); 

Files.walkFileTree(fs.getPath("/"), new SimpleFileVisitor<Path>() 


public FileVisitResult visitFile(Path file, BasicFileAttributes attrs) throws IOException 


{ 
System. out.printin(fi le) ; 
return FileVisitResult. CONTINUE; 
} 
i$} 


这 比 2.3.3 节 中 描述 的 API 要 好 用 ， 它 使 用 的 是 多 个 专门 处 理 ZIP 文档 的 新 类 。 


华章 
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e static FileSystem newFileSystem(Path path, ClassLoader loader) 
XP TEBE ARSE EA ET IAN, FF AMIR loader 不 为 nu11， 那 么 就 还 迭代 给 
we AS HN aie BE WS DBR AY SC EAA BE, E ea SY VA EAS A Fe PRE CE BEE 
者 创建 的 文件 系统 。 默 认 情 况 下 ， 对 于 ZIP 文件 系统 是 有 一 个 提供 者 的 ， 它 接受 名 字 
以 .zip 或 .jar 结尾 的 文件 。 





e static Path getPath(String first, String... more) 
将 给 定 的 字符 串 连接 起 来 创建 一 个 路 径 。 


2.6 ”内 存 映射 文件 


大 多 数 操作 系统 都 可 以 利用 虚拟 内 存 实现 来 将 一 个 文件 或 者 文件 的 一 部 分 “映射 ”到 内 
存 中 。 然 后 ， 这 个 文件 就 可 以 当 作 是 内 存 数组 一 样 地 访问 ， 这 比 传统 的 文件 操作 要 快 得 多 。 


2.6.1 内存 映 射 文件 的 性 能 


在 本 节 的 末尾 ， 你 可 以 发 现 一 个 计算 传统 的 文件 输入 和 内 存 映射 文件 的 CRC32 校 验 和 
的 程序 。 在 同一 台 机 器 上 ， 我 们 对 JDK 的 jreV 


2-5 作 的 处 理 时 | 
lib 目录 中 的 37MB 的 rt.jar 文件 用 不 同 的 方 i ithe loci 


式 来 计算 校 验 和 ， 记 录 下 来 的 时 间 数 据 如 表 2-5 -ZZ Ha 

所 不 。 带 缓冲 的 输入 流 9.9 秒 
正如 你 所 见 ， 在 这 台 特 定 的 机 器 上 ， 内 存 映 射 随机 访问 文件 162 # 

比 使 用 带 缓冲 的 顺序 输入 要 稍微 快 一 点 ， 但 是 比 使 内 存 映射 文件 7.2 秒 


用 RandomAccessFile 快 很 多 。 

当然 ， 精 确 的 值 因 机 器 不 同 会 产生 很 大 的 差异 ， 但 是 很 明显 ， 与 随机 访问 相 比 ， 性 能 提 
高 总 是 很 显著 的 。 男 一 方面 ， 对 于 中 等 尺寸 文件 的 顺序 读 入 则 没有 必要 使 用 内 存 映射 。 

java.nio 包 使 内 存 映 射 变 得 十 分 简单 ， 下 面 就 是 我 们 需要 做 的 。 

首先 ， 从 文件 中 获得 一 个 通道 (channel)， 通 道 是 用 于 磁盘 文件 的 一 种 抽象 ， 它 使 我 们 可 
以 访问 诸如 内 存 映 射 、 文 件 加 锁 机 制 以 及 文件 间 快 速 数据 传递 等 操作 系统 特性 。 

FileChannel channel = FileChannel.open(path, options); 

然后 ， 通 过 调用 FileChannel 类 的 map 方法 从 这 个 通道 中 获得 一 个 ByteBuffer。 你 
可 以 指定 想 要 映射 的 文件 区 域 与 映射 模式 ,支持 的 模式 有 三 种 : 

e FileChannel .MapMode.READ_ONLY : 所 产生 的 缓冲 区 是 只 读 的 ， 任 何 对 该 缓冲 区 写 

入 的 尝试 都 会 导致 Read0n1yBufferException 异常 。 
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e FileChannel.MapMode.READ_WRITE: 所 产生 的 缓冲 区 是 可 写 的 ， 任 何 修改 都 会 在 
某 个 时 刻写 回 到 文件 中 。 注 意 ， 其 他 映射 同一 个 文件 的 程序 可 能 不 能 立即 看 到 这 些 修 
改 ， 多 个 程序 同时 进行 文件 映射 的 确切 行为 是 依赖 于 操作 系统 的 。 

e FileChannel .MapMode.PRIVATE: 所 产生 的 缓冲 区 是 可 写 的 ,但 是 任何 修改 对 这 个 
缓冲 区 来 说 都 是 私有 的 ， 不 会 传播 到 文件 中 。 

一 旦 有 了 缓冲 区 ， 就 可 以 使 用 ByteBuffer 类 和 Buffer 超 类 的 方法 读 写 数据 了 。 

缓冲 区 支持 顺序 和 随机 数据 访问 ， 它 有 一 个 可 以 通过 get 和 put 操作 来 移动 的 位 置 。 例 

如 ， 可 以 像 下 面 这 样 顺序 遍历 缓冲 区 中 的 所 有 他方 : 
while (buffer.hasRemaining()) 


byte b = buffer.get(); 


} 
或 者 ， 像 下 面 这 样 进行 随机 访问 : 


for (int 1 = 0; 1 < buffer. JimtQ; i++) 
byte b = buffer.get(i); 


} 
你 可 以 用 下 面 的 方法 来 读 写字 市 数组 : 


get(byte[] bytes) 
get(byte[], int offset, int length) 


最 后 ， 还 有 下 面 的 方法 : 


getInt 
getLong 
getShort 
getChar 
getFloat 
getDouble 


用 来 读 入 在 文件 中 存储 为 二 进 制 值 的 基本 类 型 值 。 正 如 我 们 提 到 的 ，Java 对 二 进 制 数据 使 用 
高 位 在 前 的 排序 机 制 ， 但 是 ， 如 果 需 要 以 低位 在 前 的 排序 方式 处 理 包 含 二 进 制 数字 的 文件 ， 
那么 只 需 调用 

buffer,order(Byte0rder,LITTLE_ENDIAN) ; 

要 查询 缓冲 区 内 当前 的 字 节 顺序 ， 可 以 调用 : 

Byte0rder b = buffer.order() 
人 警告 : 这 一 对 方法 没有 使 用 set/get 命名 惯例 。 

要 向 缓冲 区 写 数字 ， 可 以 使 用 下 列 的 方法 : 


putInt 
putLong 
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putShort 
putChar 
putFloat 
putDouble 


在 恰当 的 时 机 ， 以 及 当 通 道 关闭 时 ， 会 将 这 些 修改 写 回 到 文件 中 。 

程序 清单 2-5 用 于 计算 文件 的 32 位 的 循环 元 余 校 验 和 (CRC32 )， 这 个 数值 就 是 经 常 
用 来 判断 一 个 文件 是 否 已 损坏 的 校 验 和 ， 因 为 文件 损坏 极 有 可 能 导致 校 验 和 改变 。java. 
uti1.zip 包 中 包含 一 个 CRC32 类 ， 可 以 使 用 下 面 的 循环 来 计算 一 个 字 节 序列 的 校 验 和 : 


CRC32 crc = new CRC32(); 
while (more bytes) 


crc.update(next byte) 


long checksum = crc.getValue() ; 


注意 : 对 CRC 算法 有 一 个 很 精细 的 解释 ， 请 查看 http://www.relisoft.com/ Science/ 
CreMath.html. 


CRC 计算 的 细节 并 不 重要 ， 我 们 只 是 将 它 作 为 一 个 有 用 的 文件 操作 的 实例 来 使 用 。( 在 
实践 中 ， 每 次 会 以 更 大 的 工夫 而 不 是 一 个 字 节 为 单位 来 读 取 和 更 新 数据 ， 而 它们 的 速度 差异 


并 不 明显 。) 
应 该 像 下 面 这 样 运行 程序 : 


java memoryMap.MemoryMapTest filename 
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package memoryMap; 


import java.i0.*; 

import java.nio.*; 

import java.nio.channels.*; 
import java.nio.file.*; 
import java.util.zip.*; 


/** 


* This program computes the CRC checksum of a file in four ways. <br> 
* Usage: java memoryMap.MemoryMapTest filename 

* @version 1.01 2012-05-30 

* @author Cay Horstmann 

* 


public class MemoryMapTest 
public static long checksumInputStream(Path filename) throws IOException 
{ 
try (InputStream in = Files.newInputStream(fi|ename) ) 


CRC32 crc = new CRC32(); 


int C; 
while ((c = in.read()) != -1) 
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crc.update(c) ; 
return crc.getValue(); 
} 
} 


public static long checksumBufferedInputStream(Path filename) throws IOException 


{ 
try (InputStream in = new BufferedInputStream(Files.newInputStream(fi lename) )) 


CRC32 crc = new CRC32(); 


int C; 
while ((c = in.read()) != -1) 
crc.update(c) ; 
return crc.getValue() ; 
} 
} 


public static long checksumRandomAccessFile(Path filename) throws IOException 


try (RandomAccessFile file = new RandomAccessFile(filename.toFile(), "r")) 


{ 
long length = file.length(); 
CRC32 crc = new CRC32(); 


for (long p = 0; p < length; p++) 
file.seek(p) ; 
int c = file. readByte(); 
crc.update(c) ; 


return crc.getValue(); 
} 
} 


public static long checksumMappedFile(Path filename) throws IOException 
try (FileChannel channel = FileChannel .open(filename)) 


CRC32 crc = new CRC32(); 
int length = (int) channel.size(); 


MappedByteBuffer buffer = channel.map(FileChannel.MapMode.READ_ONLY, 0, length); 


for (int p = 0; p < length; p++) 
{ 


int c = buffer.get(p); 
crc.update(c) ; 


return crc.getValue(); 
} 
} 


public static void main(String[] args) throws IOException 


{ 


i 
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79 System.out.println("Input Stream:"); 

80 long start = System.currentTimeMillis(); 

81 Path filename = Paths.get(args[0]); 

82 long crcValue = checksumInputStream(fi]ename) ; 

83 long end = System.currentTimeMillisQ; 

84 System.out.printIn(Long. toHexString(crcValue)) ; 

85 System.out.printIn((end - start) + " milliseconds"); 
86 

87 System.out.printIn("Buffered Input Stream:"); 

88 start = System. currentTimeMillis(); 

89 crcValue = checksumBufferedInputStream(fi]ename) ; 

90 end = System.currentTimeMillis(); 

91 System. out. print] n(Long. toHexString(crcValue)) ; 

92 System.out.print]n((end - start) + " milliseconds"); 
93 

94 System.out.printIn("Random Access File:"); 

95 start = System.currentTimeMillisQ; 

96 crcValue = checksumRandomAccessFile(filename); 

97 end = System.currentTimeMillis(); 

98 System. out.print]n(Long. toHexString(crcValue)) ; 

99 System.out.printIn((end - start) + " milliseconds"); 
100 

101 System.out.printIn("Mapped File:"); 

102 start = System.currentTimeMillis(); 

103 crcValue = checksumMappedFile(filename) ; 

104 end = System.currentTimeMillis(); 

105 System. out. printIn(Long. toHexString(crcValue)) ; 

106 System.out.printIn((end - start) + " milliseconds"); 
107 } 

108 } 






eFileChannel getChannel() 1.4 
返回 用 于 访问 这 个 输入 流 的 通道 。 









eFileChannel getChannel() 1.4 
返回 用 于 访问 这 个 输出 流 的 通道 。 





eFileChannel getChannel() 1.4 
返回 用 于 访问 这 个 文件 的 通道 。 






estatic FileChannel open(Path path, OpenOption... options) 7 
打开 指定 路 径 的 文件 通道 ， 默 认 情 况 下 ， 通道 打 开 时 用 于 读 入 。 
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参数 : path 打开 通道 的 文件 所 在 的 路 径 
options StandardOpenOption 枚 举 中 的 WRITE, APPEND, TRUNCATE_EXISTING, 
CREATE 值 
e MappedByteBuffer map(FileChannel.MapMode mode, long position, long 


size) 
将 文件 的 一 个 区 域 映射 到 内 存 中 。 
参数 : mode FileChannel1.MapMode 类 中 的 常量 READ_ONLY、READ_WRITE、 


或 PRIVATE 之 一 
position 映射 区 域 的 起 始 位 置 
size 映射 区 域 的 大 小 





e boolean hasRemaining() 


如 果 当 前 的 缓冲 区 位 置 没 有 到 达 这 个 缓冲 区 的 界限 位 置 ， 则 返回 true, 


e int limit() 
返回 这 个 缓冲 区 的 界限 位 置 ， 即 没有 任何 值 可 用 的 第 一 个 位 置 。 





ebyte get() 
MSRM BRE TED, FPR SAIL IB FP 
e byte get(int index) 
MEERI — TED 
e ByteBuffer put(byte b) 
向 当前 位 置 推 人 一 个 字 节 ， 并 将 当前 位 置 移动 到 下 一 个 字 节 。 返 回 对 这 个 缓冲 区 的 
引用 。 
e ByteBuffer put(int index, byte b) 
向 指定 索引 处 推 人 一 个 字 节 。 返 回 对 这 个 缓冲 区 的 引用 。 
e ByteBuffer get(byte[] destination) 
e ByteBuffer get(byte[] destination, int offset, int length) 
用 缓冲 区 中 的 字 节 来 填充 字 节 数组 ， 或 者 字 节 数组 的 某 个 区 域 ， 并 将 当前 位 置 向 前 
移动 读 入 的 字 节 数 个 位 置 。 如 果 缓 冲 区 不 够 大 ， 那 么 就 不 会 读 入 任何 字 市 ， 并 抛 出 
BufferUnderf low Exception。 返 回 对 这 个 缓冲 区 的 引用 。 
参数 : destination 要 填充 的 字 节 数组 
offset 要 填充 区 域 的 偏 移 量 
length 要 填充 区 域 的 长 度 
e ByteBuffer put(byte[] source) 
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e ByteBuffer put(byte[L] source, int offset, int length) 
将 字 节 数组 中 的 所 有 字 节 或 者 给 定 区 域 的 字 节 都 推 人 缓冲 区 中 ， 并 将 当前 位 置 回 前 
移动 写 出 的 字 节 数 个 位 置 。 如 果 绥 冲 区 不 够 大 ， 那 么 就 不 会 读 入 任何 字 节 ， 并 抛 出 
BufferUnderflow Exception。 返 回 对 这 个 缓冲 区 的 引用 。 
参数 : source ”要 写 出 的 数组 
offset ”要 写 出 区 域 的 偏 移 量 
length 要 写 出 区 域 的 长 度 
è Xxx getXxx() 
e Xxx getXxx(int index) 
e ByteBuffer putXxx(Xxx value) 
e ByteBuffer putXxx(int index, Xxx value) 
获得 或 放置 一 个 二 进 制 数 。Xxx 是 Int、Long、Short、Char、Float 或 Double 中 
的 一 个 。 
e ByteBuffer order(ByteOrder order) 
e ByteOrder order() 
设置 或 获得 字 节 顺序 ，order 的 值 是 ByteOrder 类 的 常量 BIG_ENDIAN 或 LITTLE_ 
ENDIAN 中 的 一 个 。 
e static ByteBuffer allocate(int capacity) 
构建 具有 给 定 容量 的 缓冲 区 。 
estatic ByteBuffer wrap(byte[] values) 
构建 具有 指定 容量 的 缓冲 区 ， 该 缓冲 区 是 对 给 定数 组 的 包装 。 
e CharBuffer asCharBuffer() 
构建 字符 缓冲 区 ， 它 是 对 这 个 缓冲 区 的 包装 。 对 该 字符 缓冲 区 的 变更 将 在 这 个 缓冲 区 
中 反映 出 来 ， 但 是 该 字符 缓冲 区 有 自己 的 位 置 、 界 限 和 标记 。 





echar get() 


e CharBuffer get(char[] destination) 

e CharBuffer get(char[] destination, int offset, int length) 
从 这 个 缓冲 区 的 当前 位 置 开 始 ， 获 取 一 个 char 值 ， 或 者 一 个 范围 内 的 所 有 char 值 ， 
然后 将 位 置身 前 移动 越过 所 有 读 和 人 的 字符 。 最 后 两 个 方法 将 返回 this, 

e CharBuffer put(char c) 

e CharBuffer put(char[] source) 

e CharBuffer put(char[] source, int offset, int length) 

e CharBuffer put(String source) 


e CharBuffer put(CharBuffer source) 
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从 这 个 缓冲 区 的 当前 位 置 开始 ， 放 置 一 个 char 值 ， 或 者 一 个 范围 内 的 所 有 char 18, 
然后 将 位 置 向 前 移动 越过 所 有 被 写 出 的 字符 。 当 放置 的 值 是 从 CharBuffer ZAR, 
将 读 入 所 有 剩余 字符 。 所 有 方法 将 返回 上 this。 


26.2 ”缓冲 区 数据 结构 


在 使 用 内 存 映射 时 ， 我 们 创建 了 单一 的 缓冲 区 横 跨 整 个 文件 或 我 们 感 兴趣 的 文件 区 域 。 
我 们 还 可 以 使 用 更 多 的 缓冲 区 来 读 写 大 小 适度 的 信息 块 。 

本 节 将 简要 地 介绍 Buffer 对 象 上 的 基本 操作 。 缓 冲 区 是 由 具有 相同 类 型 的 数值 构成 的 
数组 ，Buffer 类 是 一 个 抽象 类 ， 它 有 众多 的 具体 子 类 ， 包 括 ByteBuffer、CharBuffer、 
DoubleBuffer、 IntBuffer、LongBuffer 和 ShortBuffer。 


注意 : StringBuffer 类 与 这 些 缓冲 区 没有 关系 。 

在 实践 中 ， 最 常用 的 将 是 ByteBuffer 和 CharBuffer。 如 图 2-10 所 示 ， 每 个 缓冲 区 都 
具有 : 

一 个 容量 ， 它 永远 不 能 改变 。 

e 一 个 读 写 位 置 ， 下 一 个 值 将 在 此 进行 读 写 。 

e 一 个 界限 ， 超 过 它 进 行 读 写 是 没有 意义 的 。 

e 一 个 可 选 的 标记 ， 用 于 重复 一 个 读 人 或 写 出 操作 。 


FR 





图 2-10 一 个 缓冲 区 


这 些 值 满 足下 面 的 条 件 : 

0 sl sii SARS AE 

使 用 缓冲 区 的 主要 目的 是 执行 “ 写 ， 然 后 读 人 ”循环 。 假 设 我 们 有 一 个 缓冲 区 ， 在 一 开 
始 ， 它 的 位 置 为 0， 界 限 等 于 容量 。 我 们 不 断 地 调用 put 将 值 添 加 到 这 个 缓冲 区 中 ， 当 我 们 
耗 尽 所 有 的 数据 或 者 写 出 的 数据 量 达 到 容量 大 小 时 ， 就 该 切换 到 读 人 操作 了 。 

这 时 调用 Flip 方法 将 界限 设置 到 当前 位 置 ， 并 把 位 置 复位 到 0。 现 在 在 remaining 方 
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法 返回 正 数 时 ( 它 返回 的 值 是 “界限 - 位 置 ”)， 不 断 地 调用 get。 在 我 们 将 缓冲 区 中 所 有 的 
值 都 谈 和 人 之 后 ， 调 用 clear 使 缓冲 区 为 下 一 次 写 循环 做 好 准备 。c1lear 方法 将 位 置 复位 到 0, 
并 将 界限 复位 到 容量 。 

如 果 你 想 重读 缓冲 区 ， 可 以 使 用 rewind 或 mark/reset 方法 ， 详 细 内 容 请 查看 API 
注释 。 

要 获取 缓冲 区 ， 可 以 调用 诸如 ByteBuffer.allocate 或 ByteBuffer .wrap 这 样 的 静 
态 方法 。 

然后 ， 可 以 用 来 自 某 个 通道 的 数据 填充 缓冲 区 ， 或 者 将 缓冲 区 的 内 容 写 出 通道 中 。 例 如 : 


ByteBuffer buffer = ByteBuffer.allocate(RECORD SIZE) ; 
channel .read (buffer); 

channel .position(newpos) ; 

buffer. flipQ; 

channel .write (buffer) ; 


这 是 一 种 非常 有 用 的 方法 ， 可 以 替代 随机 访问 文件 。 





e Buffer clear() 
通过 将 位 置 复 位 到 0， 并 将 界限 设置 到 容量 ， 使 这 个 缓冲 区 为 写 出 做 好 准备 。 返 回 
this, | 

e Buffer flip() 
通过 将 界限 设置 到 位 置 ， 并 将 位 置 复位 到 0， 使 这 个 缓冲 区 为 读 入 做 好 准备 。 返 回 
this, 

e Buffer rewind( ) 
通过 将 读 写 位 置 复位 到 0， 并 保持 界限 不 变 ， 使 这 个 缓冲 区 为 重新 恋人 相同 的 值 做 好 准 
备 。 返 回 this。 

e Buffer mark() 
将 这 个 缓冲 区 的 标记 设置 到 读 写 位 置 ， 返 回 this。 

e Buffer reset() 
将 这 个 缓 神 区 的 位 置 设置 到 标记 ， 从 而 允许 被 标记 的 部 分 可 以 再 次 被 读 人 或 写 出 ， 返 
la] this, 

e int remaining( ) 
返回 剩余 可 读 人 或 可 写 出 的 值 的 数量 ， 即 界限 与 位 置 之 间 的 差异 。 

e int position() 

e void position(int newValue) 
返回 这 个 缓冲 区 的 位 置 。 

e int capacity() 
返回 这 个 缓冲 区 的 容量 。 





Z288 输入 与 输出 105 


2.6.3 ”文件 加 锁 机 制 


考虑 一 下 多 个 同时 执行 的 程序 需要 修改 同一 个 文件 的 情形 ， 很 明显 ， 这 些 程序 需要 以 某 
种 方式 进行 通信 ， 不 然 这 个 文件 很 容易 被 损坏 。 文 件 锁 可 以 解决 这 个 问题 ， 它 可 以 控制 对 文 
件 或 文件 中 某 个 范围 的 字 市 的 访问 。 

假设 你 的 应 用 程序 将 用 户 的 偏好 存储 在 一 个 配置 文件 中 ， 当 用 户 调用 这 个 应 用 的 两 个 实 
例 时 ， 这 两 个 实例 就 有 可 能 会 同时 希望 写 这 个 配置 文件 。 在 这 种 情况 下 ， 第 一 个 实例 应 该 锁 
定 这 个 文件 ， 当 第 二 个 实例 发 现 这 个 文件 被 锁定 时 ， 它 必须 决策 是 等 待 直至 这 个 文件 解锁 ， 
还 是 直接 跳 过 这 个 写 操作 过 程 。 

要 锁定 一 个 文件 ， 可 以 调用 FileChannel 类 的 lock 或 tryLock 方法 : 


FileChannel = FileChannel.open(path) ; 
FileLock lock = channel.lockQ); 


或 

FileLock lock = channel.tryLock() ; 

第 一 个 调用 会 阻塞 直至 可 获得 锁 ， 而 第 二 个 调用 将 立即 返回 ， 要么 返回 锁 ， 要 人 么 在 锁 不 
可 获得 的 情况 下 返回 nu11。 这 个 文件 将 保持 锁定 状态 ， 直 至 这 个 通道 关 团 ， 或 者 在 锁 上 调 
用 了 release 方法 。 

你 还 可 以 通过 下 面 的 调用 锁定 文件 的 一 部 分 : 

FileLock lock(long start, long size, boolean shared) 

或 

FileLock tryLock(long start, long size, boolean shared) 

如 果 shared 标志 为 false， 则 锁定 文件 的 目的 是 读 写 ， 而 如 果 为 true， 则 这 和 是 一 个 
享 锁 ， 它 允许 多 个 进程 从 文件 中 读 入 ， 并 阻止 任何 进程 获得 独占 的 锁 。 ak hi 
都 支持 共享 锁 ， 因 此 你 可 能 会 在 请 求 共享 锁 的 时 候 得 到 的 是 独占 的 锁 。 调 用 Fi1eLock 类 的 
isShared 方法 可 以 查询 你 所 持 有 的 锁 的 类 型 。 


图 注意 : 如 果 你 锁定 了 文件 的 尾部 ， 而 这 个 文件 的 长 度 随后 增长 超过 了 锁定 的 部 分 ， 那 么 
增长 出 来 的 额外 区 域 是 未 锁定 的 ， 要 想 锁定 所 有 的 字 节 ， 可 以 使 用 Long.MAX_VALUE 来 
表示 尺寸 。 


要 确保 在 操作 完成 时 释放 锁 ， 与 往常 一 样 ， 最 好 在 一 个 try 语句 中 执行 释放 锁 的 操作 : 
try (FileLock lock = channel. lock()) 


access the locked file or segment 


请 记 住 ,文件 加 锁 机 制 是 依赖 于 操作 系统 的 ， 下 面 是 需要 注意 的 几 扩 : 
o 在 某 些 系统 中 ， 文 件 加 锁 仅仅 是 建议 性 的 ， 如 果 一 个 应 用 未 能 得 到 锁 ， 它 仍旧 可 以 问 
被 另 一 个 应 用 并 发 锁定 的 文件 执行 写 操作 。 


106 Java ZSRR A ZAR 


e 在 某 些 系统 中 ， 不 能 在 锁定 一 个 文件 的 同时 将 其 映射 到 内 存 中 。 

e 文件 锁 是 由 整个 Java 虚拟 机 持 有 的 。 如 果 有 两 个 程序 是 由 同一 个 虚拟 机 启动 的 (例如 
Applet 和 应 用 程序 启动 器 )， 那 么 它们 不 可 能 每 一 个 都 获得 一 个 在 同一 个 文件 上 的 锁 。 
当 调 用 lock 和 tryLock 方法 时 ， 如 果 虚 拟 机 已 经 在 同一 个 文件 上 持 有 了 另 一 个 重叠 
的 锁 ， 那 么 这 两 个 方法 将 抛 出 OverlappingFileLockException, 

e 在 一 些 系统 中 ， 关 闭 一 个 通道 会 释放 由 Java 虚拟 机 持 有 的 底层 文件 上 的 所 有 锁 。 因 
此 ， 在 同一 个 锁定 文件 上 应 避免 使 用 多 个 通道 。 

© 在 网 络 文件 系统 上 锁定 文件 是 高 度 依赖 于 系统 的 ， 因 此 应 该 尽量 避免 。 





e FileLock lock() 
在 整个 文件 上 获得 一 个 独占 的 锁 ， 这 个 方法 将 阻塞 直至 获得 锁 。 
e FileLock tryLock() 
在 整个 文件 上 获得 一 个 独占 的 锁 ， 或 者 在 无 法 获得 锁 的 情况 下 返回 nu11。 


eFileLock lock(long position, long size, boolean shared) 


eFileLock tryLock( long position, long size, boolean shared) 


在 文件 的 一 个 区 域 上 获得 锁 。 第 一 个 方法 将 阻塞 直至 获得 锁 ， 而 第 二 个 方法 将 在 无 法 


获得 锁 时 返回 null, 
参数 : position 要 锁定 区 域 的 起 始 位 置 
size 要 锁定 区 域 的 尺寸 


shared true HER, false 为 独占 锁 





e void close() 1.7 


释放 这 个 锁 。 


2.7 ”正则 表达 式 


正则 表达 式 ( regular expression) 用 于 指定 字符 串 的 模式 ， 你 可 以 在 任何 需要 定位 匹配 某 种 
特定 模式 的 字符 串 的 情况 下 使 用 正则 表达 式 。 例 如 ， 我 们 有 一 个 示例 程序 就 是 用 来 定位 HTML 
文件 中 的 所 有 超 链 接 的 ， 它 是 通过 查找 <a href =“"..."> 模 式 的 字符 串 来 实现 此 目的 的 。 

当然 ， 在 指定 模式 时 ，... 标记 法 并 不 够 精确 。 你 需要 精确 地 指定 什么 样 的 字符 序列 才 是 
合法 的 匹配 ， 这 就 要 求 无 论 何 时 ， 当 你 要 描述 一 个 模式 时 ， 都 需要 使 用 某 种 特定 的 语法 。 

下 面 是 一 个 简单 的 示例 ， 正 则 表达 式 


[Jj]ava.+ 


匹配 下 列 形式 的 所 有 字符 串 : 





BZ2¢ BAIE 107 


e 第 一 个 字母 是 J 或 j。 
e 接 下 来 的 三 个 字母 是 ava。 
e 字符 串 的 其 余部 分 由 一 个 或 多 个 任意 的 字符 构成 。 
例如 ， 字 符 串 “javanese” 就 匹配 这 个 特定 的 正则 表达 式 ， 但 是 字符 串 “core java” 
就 不 匹配 。 
正如 你 所 见 ， 你 需要 了 解 一 点 这 种 语法 ， 以 理解 正则 表达 式 的 含义 。 幸 运 的 是 ， 对 于 大 
多 数 情况 ， 一 小 部 分 很 直观 的 语法 结构 就 足够 用 了 。 
o 字符 类 (character class) 是 一 个 括 在 括号 中 的 可 选择 的 字符 集 ， 例 如 ，[Jj]j、[0-9]、 
[A-Za-z] 或 [^0-9]。 这 里 “-” 表 示 是 一 个 范围 (所 有 Unicode 值 落 在 两 个 边界 范围 
之 内 的 字符 )， 而 ^ 表 示 补 集 (除了 指定 字符 之 外 的 所 有 字符 )。 
e 如 果 字 符 类 中 包含 “-”， 那 么 它 必须 是 第 一 项 或 最 后 一 项 ; MRR “CO”, WAE 
必须 是 第 一 项 ; 如 果 要 包含 “^”， 那 么 它 可 以 是 除开 始 位 置 之 外 的 任何 位 置 a 其 中 ， 
你 只 需要 转 义 “[” 和 “\”。 
o 有 许多 预定 的 字符 类 ， 例 如 \d (数字 ) 和 \p{Sc} (Unicode 货币 符号 )。 请 查看 表 2-6 


和 表 2-7。 
% 2-6 正则 表达 式 语法 
表达 式 示例 
字符 
ce 71 OLS 25h 





任何 除 行 终止 符 之 外 的 字符 ， 或 者 在 
DOTALL 标志 被 设置 时 表示 任何 字符 


\x {p} 十 六 进 制 码 为 p 的 Unicode 码 点 \x{1D546} 
\uhhhh,\xhh, \00, \000, \Qo00 具有 给 定 十 六 进 制 或 八进制 值 的 码 元 NuFEFF 


\a, ve, VF, NI Are NE 响 铃 符 (\x{7}))、 转 义 符 (\x{18})、 换 | \n 
页 符 (\x{8})、 换 行 符 (\x{A})、 回 车 符 
(\x{D})、 指 标 符 Ox?) 


\cc， 其 中 cc 在 [A,Z] 的 范围 | 对 应 于 字符 c 的 控制 字符 \cH 是 退 格 符 (\x{8}) 
\c， 其 中 c 不 在 [A-Za-z0-9] \\ 
的 范围 内 


N\Q. . .NE 在 左 引号 和 右 引 号 之 间 的 所 有 字符 NQ(. ..)NXE 匹 配 字 符 串 (...) 


字符 类 


[CiC.]， 其 中 C, 是 多 个 字符 ,| ”任何 由 Ci, Cn … 表 示 的 字符 [0-9+-] 
范围 从 c-d， 或 者 是 字符 类 


Fw aw 某 个 字符 类 的 补 集 [A\d\s] 
[...&&...] 字符 集 的 交集 [N\p{L}&&[^A-Za-z]] 


\p{...},\P{...} 某 个 预定 义 字 符 类 (参阅 表 2-7); 它 的 | \p{L} 匹配 一 个 Unicode FE, 
补 集 而 \pL 也 匹配 这 个 字母 ， 可 以 忽 
| 略 单个 字母 情况 下 的 括号 
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( 续 ) 


RAR T A 
数字 ([0-9]， 或 者 在 UNICODE_CHARACTER_| \d+ 是 一 个 数字 序列 
CLASS 标志 被 设置 时 表示 \p{Digit}); € 
的 补 集 
单词 字符 ([a-zA-Z0-9]， 或 者 在 UNICODE_ 
CHARACTER_CLASS 标 志 被 设置 时 表示 
Unicode 单词 字符 ); 它 的 补 集 l 
23% (CE NnNrNtNfNx{8}]， 或 者 在 UNICODE_| \s*,\s* 是 由 可 选 的 空格 字符 
CHARACTER_CLASS 标志 被 设置 时 表示 | 包围 的 逗号 
\p{IsWhite_Space}); 它 的 补 集 
\h, \v, \H, AY 水 平 空 白字 符 、 垂 直 空 白字 符 ， 它 们 的 
补 集 






\d, \D 











\w, \W 













Ns, \S 


序列 和 选择 


xY 任何 X 中 的 字符 串 ， 后 面 跟随 任何 Y 中 | [1-9][0-9]* 表示 没有 前 导 零 
的 字符 串 的 正 整数 


a 

(X) HAAK X KIEME '([^']*)' 捕获 的 是 被 引用 的 
ee he 

\n 第 nn 组 (['"]).x*\1 可 以 匹配 'Fred' 

(?<name>X) 捕获 与 给 定名 字 匹 配 的 X '(?<id>[A-Za-z0-9]+)' 可 


\k<name> 具有 给 定名 字 的 组 \k<id> 可 以 匹配 名 字 为 id 的 组 


(?:X) 使 用 括号 但 是 不 捕获 并 在 (?:http|ftp)://(.*) 中 ， 
在 :// 之 后 的 匹配 是 和 1 







(PAL. . UD 匹配 但 是 不 捕获 给 定 标 志 开 或 关 ( 在 -之 | (?i:jpe?g) 是 大 小 写 不 敏感 
Cfi- -fe XO), HPLE LA) WX 的 匹配 
[dimsuUx] 的 范围 中 





其 他 (?...) 请 参阅 Pattern API 文档 


量词 


X CETAN 
X*, X+ OMERX, 1 MERY [1-9] [0-9]+ 是 大 于 10 的 整数 


X{n}, X{n,}, X{m, n} nX, BDn*X, mantX [0-71{1,3} 是 一 位 到 三 位 的 
八进制 数 
Q?， 其 中 0 是 一 个 量词 表达 式 | 勉强 量词 ， 在 尝试 最 长 匹配 之 前 先 尝试 | .*(<.+?>).* 捕获 尖 括号 括 起 
最 短 匹 配 来 的 最 短 序列 


'[^']*+" 匹配 单 引 号 引起 来 的 
字符 串 ， 并 且 在 字符 串 中 没有 右 
单 引号 的 情况 下 立即 匹配 失败 


Q+， 其 中 0 是 一 个 量词 表达 式 | ”占有 量词 ， 在 不 回溯 的 情况 下 获取 最 长 
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( 续 ) 
表达 式 示例 
边界 匹配 
A, '$ 输入 的 开头 和 结尾 (或 者 多 行 模式 中 的 开 | ^Java$ 匹配 输入 中 的 Java 或 
头 和 结尾 行 ) Java 构成 的 行 
NAS. W, W 输入 的 开头 ， 输 入 的 结尾 、 输 入 的 绝对 


结尾 (在 多 行 模式 中 不 会 发 生变 化 ) 
\b, \B 单词 边界 ， 非 单词 边界 \bJava\b 匹配 单词 Java 
ee 


\G 前 一 个 匹配 的 结尾 


表 2-7 与 \p 一 起 使 用 的 预定 义 字符 类 名 字 


字符 类 名 字 解释 
posixClass posixClass # Lower, Upper, Alpha, Digit, Alnum, 
Punct, Graph, Print, Cntrl XDigit, Space, 
Blank, ASCII 之 一 ， 它 会 依 UNICODE_CHARACTER_CLASS 
标志 的 值 而 被 解释 为 POSIX 或 Unicode 类 


IsScript, sc=Script, Character .UnicodeScript.forName 可 以 接受 的 脚本 
script=Script 

InBlock, b1k=Block, Character .UnicodeScript.forName 可 以 接受 的 块 
block=Block 

Category, InCategory, Unicode 通用 分 类 的 单字 母 或 双 字 母 名 字 


gc=Category, general_category=Category 

I sProperty Property Æ Alphabetic, Ideographic,Letter,L 
owercase,Uppercase,Titlecase,Punctuation, 
Control ,White_Space,Digit,Hex_Digit,Join_ 
Control ,Noncharacter_Code_Point,Assigned 之 一 


javaMethod 调用 Character. isMethod 方法 (必须 不 是 过 时 的 方法 ) 


e 大 部 分 字符 都 可 以 与 它们 自身 匹配 ， 例 如 在 前 面 示例 中 的 ava 字符 。 

e . 符号 可 以 匹配 任何 字符 (有 可 能 不 包括 行 终止 符 ， 这 取决 于 标志 的 设置 )。 

o 使 用 \ 作 为 转 义 字符 ， 例 如 , .匹配 句号 而 \ 匹配 反 斜 线 。 

e ^ FI $ 分 别 匹配 一 行 的 开头 和 结尾 。 

e 如 果 X 和 YY 是 正则 表达 式 ， AKA XY 表示 “任何 X 的 匹配 后 面 跟随 Y 的 匹配 ，X | Y 
表示 “任何 XX 或 Y 的 匹配 ”。 

e 你 可 以 将 量词 运用 到 表达 式 X: X+ 1 个 或 多 个 )X*( 0 个 或 多 个 ) GX? (0 个 或 1 个 )。 

e 默认 情况 下 ， 量 词 要 匹配 能 够 使 整个 匹配 成 功 的 最 大 可 能 的 重复 次 数 。 你 可 以 修改 这 种 
行为 ， 方法 是 使 用 后 级 ? (使 用 勉强 或 音 曾 匹配 ， 也 就 是 匹配 最 小 的 重复 次 数 ) 或 使 用 后 
e+ (使 用 占有 或 贪 焚 匹 配 ， 也 就 是 即使 让 整个 匹配 失败 ， 也 要 匹配 最 大 的 重复 次 数 )。 
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例如 ， 字 符 串 cab 匹配 [a-z]*xab ， 但 是 不 匹配 [a-z]*+ab。 在 第 一 种 情况 中 ， 表 达 式 
[a-z]* 只 匹配 字符 c， 使 得 字符 ab 匹配 该 模式 的 剩余 部 分 ; 但 是 贪 禁 版 本 [a-z]*+ 将 匹 
配 字符 cab ， 模 式 的 剩余 部 分 将 无 法 匹配 。 

o 我 们 使 用 群 组 来 定义 子 表达 式 ， 其 中 群 组 用 括号 (0) 括 起 来 。 例 如 ,([+-]?)([0-9]+)。 

然后 你 可 以 询问 模式 匹配 器 ， 让 其 返回 每 个 组 的 匹配 ， 或 者 用 \n 来 引用 某 个 群 组 ， 其 
P n 是 群 组 号 (从 和 1 开始 )。 

例如 ， 下 面 是 一 个 有 些 复杂 但 是 却 可 能 很 有 用 的 正则 表达 式 ， 它 描述 了 十 进 制 和 十 六 进 
制 整数 : 

[+-]?[0-9]+|0[Xx] [0-9A-Fa-f]+ 

遗憾 的 是 ， 在 使 用 正则 表达 式 的 各 种 程序 和 类 库 之 间 ， 表 达 式 语法 并 未 完全 标准 化 。 尽 
管 在 基本 结构 上 达成 了 一 致 ， 但 是 它们 在 细节 上 仍旧 存在 着 许多 令 人 抓 狂 的 差异 。Java 正 
则 表达 式 类 使 用 的 语法 与 Perl 语言 使 用 的 语法 十 分 相似 ， 但 是 并 不 完全 一 样 。 表 2-6 展示 
的 是 Java 语法 中 的 所 有 结构 。 关 于 正则 表达 式 语法 的 更 多 信息 ， 可 以 求教 于 Pattern 类 的 
API 文档 和 Jeffrey E. F. Friedl 的 《 Mastering Regular Expressions ) (O’ Reilly and Associates, 
2006). 

正则 表达 式 的 最 简单 用 法 就 是 测试 某 个 特定 的 字符 串 是 否 与 它 匹配 。 下 面 展示 了 如 何 用 
Java 来 编写 这 种 测试 ， 首 先 用 表示 正则 表达 式 的 字符 串 构建 一 个 Pattern 对 象 。 然 后 从 这 
个 模式 中 获得 一 个 Matcher ， 并 调用 它 的 matches 方法 : 


Pattern pattern = Pattern. compile(patternString); 
Matcher matcher = pattern.matcher(input) ; 
if (matcher.matches()) .. . 


XP DE Ac a AY fA BY DA ee FE fay SEL CharSequence 接口 的 类 的 对 象 ， 例 如 String, 
StringBuilder 和 CharBuffer 。 
在 编译 这 个 模式 时 ， 你 可 以 设置 一 个 或 多 个 标志 ， 例 如 : 


Pattern pattern = Pattern.compile(expression, 
Pattern.CASE_INSENSITIVE + Pattern. UNICODE_CASE) ， 


或 者 可 以 在 模式 中 指定 它们 : 

String regex = "(?iU: expression)"; 

下 面 是 各 个 标志 。 

e Pattern.CASE_ INSENSITIVE Kr: 匹配 字符 时 忽略 字母 的 大 小 写 ， 默 认 情 况 下 ， 这 
个 标志 只 考虑 US ASCII 字符 。 

e Pattern.UNICODE CASE sku: 当 与 CASE INSENSITIVE 组 合 使 用 时 ， 用 Unicode F 
母 的 大 小 写 来 匹配 。 

e Pattern.UNICODE CHARACTER CLASS WẸ U: 选择 Unicode 字符 类 代替 POSIX， 其 中 
蕴含 了 UNICODE CASE. 

e Pattern.MULTILINE 或 m: ^ 和 $ 匹配 行 的 开头 和 结尾 ， 而 不 是 整个 输入 的 开头 和 结尾 。 
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e Pattern. UNIX LINES 或 d : 在 多 行 模式 中 匹配 ^ 和 $ 时 ， 只有"\n' 被 识别 成 行 终 
止 符 。 

e Pattern.DOTALL at s: 当 使 用 这 个 标志 时 ，. 符号 匹配 所 有 字符 ， 包 括 行 终止 符 。 

e Pattern.COMMENTS 或 x: 空白 字符 和 注释 (从 # 到 行 末 尾 ) 将 被 忽略 。 

e Pattern.LITERAL : 该 模式 将 被 逐 字 地 采纳 ， 必 须 精 确 匹 配 ， 因 字母 大 小 写 而 造成 的 


差异 除外 。 
e Pattern.CANON EQ; 考虑 Unicode 字符 规范 的 等 价 性 ， 例 如 ,u 后 面 跟随 “(分 音符 号 ) 
PLAC üs 


最 后 两 个 标志 不 能 在 正则 表达 式 内 部 指定 。 
WA 


Stream<String> strings =. . 
Stream<String> result = strings. filter(pattern.asPredicate()); 


其 结果 中 包含 了 匹配 正则 表达 式 的 所 有 字符 串 。 
如 果 正 则 表达 式 包 含 群 组 ， 那 么 Matcher 对 象 可 以 揭示 群 组 的 边界 。 下 面 的 方法 


int start(int groupIndex) 
int end(int groupIndex) 


将 产生 指定 群 组 的 开始 索引 和 结束 之 后 的 索引 。 

可 以 直接 通过 调用 下 面 的 方法 抽取 匹配 的 字符 串 : 

String group(int groupIndex) 

群 组 0 是 整个 输入 ， 而 用 于 第 一 个 实际 群 组 的 群 组 索引 是 1。 调 用 groupCount 方法 可 
以 获得 全 部 群 组 的 数量 。 对 于 具名 的 组 ， 使 用 下 面 的 方法 


int Start(String groupName) 
int end(String groupName) 
String group(String groupName) 


嵌 套 群 组 是 按照 前 括号 排序 的 ， 例 如 ， 假 设 我 们 有 下 面 的 模 却 
(([1-9] | 110-27) : [0-5] [0-9])) [ap]m 


和 下 面 的 输出 
11:59am 
那么 ， 匹 配器 会 报告 下 面 的 群 组 : 
群 组 索引 开始 结束 字符 串 
0 0 7 11:59am 
1 0 5 11:59 
2 0 2 11 
3 3 5 59 


程序 清单 2-6 的 程序 提示 输入 一 个 模式 ， 然 后 提示 输入 用 于 匹配 的 字符 串 ， 随 后 将 打印 
出 输入 是 否 与 模式 相 匹配 。 如 果 输 入 匹配 模式 ， 并 且 模 式 包含 群 组 ， 那 么 这 个 程序 将 用 括号 


1 HAIT 
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打印 出 群 组 边界 ， 例 如 
((11): (59))am 





1 package regex; 
2 
3 import java.util.*; 
4 Import java.util. regex.*; 


fee 
7 * This program tests regular expression matching. Enter a pattern and strings to match, 

8 *or hit Cancel to exit. If the pattern contains groups, the group boundaries are displayed 
9 * jn the match. 

10 * Q@version 1.02 2012-06-02 

11 * @author Cay Horstmann 


2 */ 

13 public class RegexTest 

14 { 

5 public static void main(String[] args) throws PatternSyntaxException 
16 { 

17 Scanner in = new Scanner (System. in); 

18 System.out.println("Enter pattern: "); 

19 String patternString = in.nextLine(); 

20 

21 Pattern pattern = Pattern.compile(patternString) ; 

22 

23 while (true) 

24 

25 System.out.printI]n("Enter string to match: "); 

26 String input = in.nextLine(); 

27 if (input == null || input.equals("")) return; 

28 Matcher matcher = pattern.matcher(input) ; 

29 if (matcher.matches()) 

30 { 

31 System.out.printIn("Match") ; 

32 int g = matcher.groupCount() ; 

33 if (g > 0) 

34 { 

35 for (int i = 0; i < input. length(); i++) 

36 { 

37 // Print any empty groups 

38 for (int j = 1; j <= g; j++) 

39 if (i == matcher.start(j) && i == matcher. end(j)) 
40 System.out.print("()"); 

41 // Print ( for non-empty groups starting here 

42 for (int j = 1; j <= g; j++) 

43 if (1 == matcher.start(j) && i != matcher.end(j)) 
44 System.out.print('('); 

45 System.out.print(input.charAt(i)); 

46 // Print ) for non-empty groups ending here 

47 for (int j = 1; j <= g; j++) 

48 if (i + 1 != matcher.start(j) && i + 1 == matcher.end(j)) 
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49 System.out.print(')'); 


51 System, out.printin(); 

52 } 

53 } 

54 else 

55 System.out.print]n("No match"); 





通常 ， 你 不 希望 用 正则 表达 式 来 匹配 全 部 输入 ， 而 只 是 想 找 出 输入 中 一 个 或 多 个 匹配 
的 子 字符 串 。 这 时 可 以 使 用 Matcher 类 的 find 方法 来 查找 匹配 内 容 ， 如 果 返 回 true, FH 
使 用 start 和 end 方法 来 查找 匹配 的 内 容 ， 或 使 用 不 带 引 元 的 group 方法 来 获取 匹配 的 字 
FEB 


while (matcher. find()) 
{ 


int start = matcher.startQ); 
int end = matcher.end(); 
String match = input.group(); 
3 
程序 清单 2-7 对 这 种 机 制 进 行 了 应 用 ， 它 定位 一 个 Web 页 面 上 的 所 有 超 文 本 引用 ， 并 打 
印 它们 。 为 了 运行 这 个 程序 ， 你 需要 在 命令 行 中 提供 一 个 URL， 例 如 


java match.HrefMatch http://horstmann.com 





package match; 


import java.i0.*; 
import java.net. *; 
import java.nio.charset.*; 
import java.util. regex. *; 


jet 
* This program displays all URLs in a web page by matching a regular expression that describes 
10 * the <a href=...> HTML tag. Start the program as <br> 
1 * java match.HrefMatch URL 
12 * @version 1.02 2016-07-14 
13 * @author Cay Horstmann 
14 */ 
15 public class HrefMatch 


OO oO yu DD ^n 和 Up N j 


ı7 public static void main(String[] args) 
18 { 
19 try 


21 // get URL string from command line or use default 


! 
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String urlString; 
if (args.length > 0) urlString = args(0]; 
else urlString = "http://java.sun.com'; 


// open reader for URL 
InputStreamReader in = new InputStreamReader(new URL(url String) .openStream() , 
StandardCharsets.UTF_8) ; 


// read contents into string builder 

StringBuilder input = new StringBuilder() ; 

int ch; 

while ((ch = in.read()) != -1) 
input.append((char) ch); 


// search for all occurrences of pattern 

String patternString = "<a\\s+href\\s*=\\s*(\"[A\"]*\"| [A\\s>]*)\\s*>"; 
Pattern pattern = Pattern.compile(patternString, Pattern.CASE_INSENSITIVE) ; 
Matcher matcher = pattern.matcher (input) ; 


while (matcher. find()) 
{ 


String match = matcher. group() ; 
System.out.printIn(match) ; 


catch (IOException | PatternSyntaxException e) 


e,printStackTrace() ; 


Matcher 类 的 replaceA11 方法 将 正则 表达 式 出 现 的 所 有 地 方 都 用 替换 字符 串 来 蔡 换 。 
例如 ， 下 面 的 指令 将 所 有 的 数字 序列 都 蔡 换 成 # 字 符 。 


Pattern pattern = Pattern.compile("[0-9]+"); 
Matcher matcher = pattern.matcher (input) ; 
String output = matcher. replaceAll ("#") ; 


替换 字符 串 可 以 包含 对 模式 中 群 组 的 引用 : $n 表示 替换 成 第 nn 个 群 组 ，${name} PA 
换 为 具有 给 定名 字 的 组 ， 因 此 我 们 需要 用 \$ 来 表示 在 替换 文本 中 包含 一 个 $ 字符 。 
如 果 字 符 串 中 包含 $ 和 \， 但 是 又 不 希望 它们 被 解释 成 群 组 的 蔡 换 和 从， 那么 束 可 以 调用 


matcher .replaceAll(Matcher .quoteReplacement(str)), 


replaceFirst 方法 将 只 替换 模式 的 第 一 次 出 现 。 
最 后 ，Pattern 类 有 一 个 sp1it 方法 ,， 它 可 以 用 正则 表达 式 来 匹配 边界 ， 从 而 将 输入 
分 割 成 字符 串 数 组 。 例 如 ， 下 面 的 指令 可 以 将 输入 分 割 成 标记 ， 其 中 分 隅 符 是 由 可 选 的 空 日 


字符 包围 的 标点 符号 。 


Pattern pattern = Pattern.compile("\\s*\\p{Punct}\\s*") ; 
String[] tokens = pattern.split(input) ; 
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如 果 有 多 个 标记 ， 那 么 可 以 惰性 地 获取 它们 : 
Stream<String> tokens = commas.splitAsStream(input) ; 
如 果 不 关心 预 编 译 模 式 和 惰性 获取 ， 那 么 可 以 使 用 String.split 方法 : 


String[] tokens = input.split("\\s*,\\s*"); 


e static Pattern compile(String expression) 


estatic Pattern compile(String expression, int flags) 


把 正则 表达 式 字符 串 编 译 到 一 个 用 于 快速 处 理 匹配 的 模式 对 象 中 。 


参数 ， expression 
flags 


正则 表达 式 
CASE_INSENSITIVE、 UNICODE_CASE、 MULTILINE, 
UNIX_LINES、DOTALL 和 CANON_EQ 标志 中 的 一 个 


e Matcher matcher(CharSequence input) 


返回 一 个 matcher 对 象 ， 你 可 以 用 它 在 输入 中 定位 模式 的 匹配 。 
e String[] split(CharSequence input) 


e String[] split(CharSequence input, int limit) 


e Stream<String> splitAsStream(CharSequence input) 8 


将 输入 分 割 成 标记 ， 其 中 模式 指定 了 分 隔 符 的 形式 。 返 回 标记 数组 ， 分 隅 符 并 非 标 记 


的 一 部 分 。 
参数 : input 
limit 






e boolean matches() 


要 分 割 成 标记 的 字符 串 

所 产生 的 字符 串 的 最 大 数量 。 如 果 已 经 发 现 了 1imit-1l 个 
匹配 的 分 隔 符 ， 那 么 返回 的 数组 中 的 最 后 一 项 就 包含 所 有 得 
余 未 分 割 的 输入 。 如 果 1imitx0， 那 么 整个 输入 都 被 分 割 ; 
如 果 1imit 为 0， 那 么 坠 尾 的 空 字 符 串 将 不 会 置 于 返回 的 数 


组 中 。 


如 果 输 入 匹配 模式 ， 则 返回 true, 


e boolean lookingAt() 


如 果 输 入 的 开头 匹配 模式 ， 则 返回 true, 


èe boolean find( ) 


e boolean find(int start) 


尝试 查找 下 一 个 匹配 ， 如 果 找 到 了 另 一 个 匹配 ， 则 返回 true, 


HM: start 
e int start() 


FY heen Be FR 85 | ME 


1 
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e int end() 
返回 当前 匹配 的 开始 索引 和 结尾 之 后 的 索引 位 置 。 
e String group() 
返回 当前 的 匹配 。 
e int groupCount() 
返回 输入 模式 中 的 群 组 数量 。 
e int start(int groupIndex ) 
e int end(int groupIndex ) 
返回 当前 匹配 中 给 定 群 组 的 开始 和 结尾 之 后 的 位 置 。 
参数 : groupIndex HAA S| (从 1 开始 )， 或 者 表示 整个 匹配 的 0 
e String group(int groupIndex ) 
返回 匹配 给 定 群 组 的 字符 串 。 
参数 : groupIndex PARI (从 1 开始 )， 或 者 表示 整个 匹配 的 0 
e String replaceAll(String replacement) 
e String replaceFirst(String replacement) 
W [E] MA DE Pic aes A RS BS OR Pr De a kc 33 — 4S DF ER SB PE I EFF 
FB 
参数 : replacement 替换 字符 串 ， 它 可 以 包含 用 $n 表示 的 对 群 组 的 引用 ， 这 时 
需要 用 \$ 来 表示 字符 串 中 包含 一 个 $ 符号 
e static String quoteReplacement(String str) 5.0 
引用 str 中 的 所 有 入 AIS. 
e Matcher reset() 
e Matcher reset(CharSequence input) 
ADL ACA ATIRAS. OPAL ACA E FATA A PIT IED 
返回 this. 
你 现在 已 经 看 到 了 在 Java 中 输入 输出 操作 是 如 何 实现 的 ， 也 对 正则 表达 式 有 了 概略 的 了 
解 。 在 下 一 章 中 ， 我 们 将 转 而 研究 对 XML 数据 的 处 理 。 
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A XML 概述 A 使 用 命名 空间 
A 解析 XML 文档 全 流 机 制 解 析 需 
A 验证 XML 文档 A 生成 XML 文档 
A 使 用 XPath 来 定位 信息 A XSL 转换 


Don Box 等 人 在 其 合 著 的 《 Essential XML ) ( Addison-Wesley 出 版 社 2000 年 出 版 ) 的 前 
言 中 半 开 玩笑 地 说 道 :“ 可 扩展 标记 语言 (Extensible Markup Language, XML) 已 经 取代 了 
Java、 设 计 模 式 、 对 象 技术 ， 成 为 软件 行业 解决 世界 饥荒 的 方案 。 ”确实 ， 正 如 你 将 在 本 章 中 
看 到 的 ，XML 是 一 种 非常 有 用 的 描述 结构 化 信息 的 技术 。XML 工具 使 处 理 和 转化 信息 变 得 
十 分 容易 。 但 是 ，XML 并 不 是 万 能 药 ， 我 们 需要 领域 相关 的 标准 和 代码 库 才 能 有 效 地 使 用 
XML。 此 外 ，XML 非但 没有 使 Java 技术 过 时 ， 还 与 Java 配合 得 很 好 。 从 20 世纪 90 FARR 
以 来 ，IBM、Apache 和 其 他 许多 公司 一 直 在 帮助 开发 用 于 XML 处 理 的 高 质量 Java Æ, HP 
大 部 分 重要 的 代码 库 都 整合 到 了 Java 平 台中 。 

本 章 将 介绍 XML， 并 涵盖 了 Java 库 的 XML 特性 。 一 如 既往 ， 我 们 将 指出 何 时 大 量 地 
使 用 XML 是 正确 的 ; 而 何 时 必须 有 保留 地 使 用 XML， 通 过 利用 良好 的 设计 和 代码 ， 来 采用 
老 办 法 解决 问题 。 


3.1 XML 概述 


EILS 章 中 ,你 已 经 看 见 过 用 属性 文件 ( property file) 来 描述 程序 配置 。 属 性 文件 
包含 了 一 组 名 / 值 对 ， 例 如: 


fontname=Times Roman 
fontsize=12 
windowsize=400 200 
color=0 50 100 


你 可 以 用 Properties 类 在 单个 方法 调用 中 读 和 人 这 样 的 属性 文件 。 这 是 一 个 很 好 的 特 
性 ,但 这 还 不 够 。 在 许多 情况 下 ， 想 要 描述 的 信息 的 结构 比较 复杂 ， 属 性 文件 不 能 很 方便 地 
处 理 它 。 例 如 ， 对 于 下 面 例子 中 的 fontname/fontsize 项 ， 使 用 以 下 的 单一 项 将 更 符合 面 
癌 对 象 的 要 求 : 

font=Times Roman 12 

但 是 ， 这 时 对 字体 描述 的 解析 就 变 得 很 讨厌 了 ， 必 须 确定 字体 名 在 何 处 结束 ， 字 体 大 小 
在 何 处 开始 。 
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属性 文件 采用 的 是 一 种 单一 的 平面 层次 结构 。 你 常常 会 看 到 程序 员 用 如 下 的 键 名 来 努力 
解决 这 种 局 限 性 : 


title. fontname=Helvetica 
title. fontsize=36 

body. fontname=Times Roman 
body. fontsize=12 


属性 文件 格式 的 另 一 个 缺点 是 要 求 键 是 唯一 的 。 如 果 要 存放 一 个 值 序 列 ， 则 需要 另 一 个 
变通 方法 ， 例如: 
menu.item.1=Times Roman 


menu. item. 2=Helvetica 
menu.item.3=Goudy Old Style 


XML 格式 解决 了 这 些 问 题 ， 因 为 它 能 够 表示 层次 结构 ， 这 比 属性 文件 的 平面 表 结 构 更 
灵活 。 
描述 程序 配置 的 XML 文件 可 能 会 像 这 样 : 


<configuration> 
<title> 
<font> 
<name>Hel veti ca</name> 
<$1Ze>36</Size> 
</font> 
</title> 
<body> 
<font> 
<name>Times Roman</name> 
<$1ze>12</size> 
</font> 
</body> 
<window> 
<width>400</width> 
<hei ght>200</hei ght> 
</window> 
<color> 
<red>0</red> 
<green>50</green> 
<blue>100</blue> 
</color> 
<menu> 
<item>Times Roman</item> 
<i tem>Hel veti ca</item> 
<item>Goudy Old Style</item> 
</menu> 
</configuration> 


XML 格式 能 够 表达 层次 结构 ， 并 且 重 复 的 元 素 不 会 被 曲解 。 

正如 上 面 看 到 的 ，XML 文件 的 格式 非常 直观 ， 它 与 HTML 文件 非常 相似 。 这 是 有 原 
因 的 ， 因 为 XML 和 HTML 格式 是 上 古老 的 标准 通用 标记 语言 (Standard Generalized Markup 
Language, SGML) 的 衍生 语言 。 
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SGML 从 20 世纪 70 年 代 开 始 就 用 于 描述 复杂 文件 的 结构 。 它 的 使 用 在 一 些 要 求 对 海量 
文献 进行 持续 维护 的 产业 中 取得 了 成 功 ， 特 别 是 在 飞机 制造 业 中 。 但 是 ，SGML 相当 复杂 ， 
所 以 它 从 未 风行 。 造 成 SGML 如 此 复杂 的 主要 原因 是 SGML 有 两 个 相互 矛盾 的 目标 。 它 既 
想 要 确保 文档 能 够 根据 其 文档 类 型 的 规则 来 形成 ， 又 想 要 通过 可 以 减少 数据 键入 的 快捷 方式 
使 数据 项 变 得 容易 表示 。XML 设计 成 了 一 个 用 于 因特网 的 SGML 的 简化 版 本 。 和 通常 情况 
一 样 ， 越 简单 的 东西 越 好 ，XML 立即 得 到 了 长 期 以 来 一 直 在 躲避 SGML 的 用 户 的 热情 追捧 。 


注意 : 在 http:/www.xml.com/axml/axml.html 处 可 以 找到 一 个 由 Tim Bray 注释 的 XML 
标准 的 极 佳 版 本 。 


尽管 HTML 和 XML 同宗 同 源 ， 但 是 两 者 之 间 存 在 着 重要 的 区 别 : 

e 与 HTML KEJ, XML 是 大 小 写 敏感 的 。 例 如 ，<H1> 和 <h1> 是 不 同 的 XML 标签 。 

e 在 HTML 中 ， 如 果 从 上 下 文中 可 以 分 清 哪里 是 段落 或 列表 项 的 结尾 ， 那 么 结束 标签 
(如 </p> 或 </1i>) 就 可 以 省 略 ， 而 在 XML 中 结束 标签 绝对 不 能 省 略 。 

e 在 XML 中 ， 只 有 单个 标签 而 没有 相对 应 的 结束 标签 的 元 素 必须 以 /结尾 ， 比 如 <img 
src="coffeecup.png"/>。 这 样 , 解析 器 就 知道 不 需要 查找 </img> 标签 了 。 

e 在 XML 中 ， 属 性 值 必 须 用 引号 括 起 来 。 在 HTML 中 ， 引 号 是 可 有 可 无 的 。 例 如 ， 
<applet code="MyApplet.class" width=300 height=300> 对 HTML 来 说 是 合 
法 的 ， 但 是 对 XML 来 说 则 是 不 合法 的 。 在 XML 中 ， 必 须 使 用 引号 ， 比 如 ，width= 
"300", 

e 在 HTML 中 ， 属 性 名 可 以 没有 值 。 例 如 ，<input type="radio" name="1anguage" 
value="Java" checked>。 在 XML 中 ， 所 有 属性 必须 都 有 属性 值 。 比 如 ，checked= 


"true" 或 checked="Checked", 


3.1.1 XML 文档 的 结构 
XML 文档 应 当 以 一 个 文档 头 开 始 ， 例 如 : 


<?xml version="1.0"?> 

或 者 
<?xml version="1.0" encoding="UTF-8"?> 

严格 来 说 ， 文 档 头 是 可 选 的 ， 但 是 强烈 推荐 你 使 用 文档 头 。 

图 注意 : 因为 建立 SGML 是 为 了 处 理 真 正 的 文档 ， 因 此 XML 文件 被 称 为 文档 ， 尽 管 许 多 
XML 文件 是 用 来 描述 通常 不 被 称 作文 档 的 数据 集 的 。 


文档 头 之 后 通常 是 文档 类 型 定义 (Document Type Definition，DTD)， 例 如 : 


<!DOCTYPE web-app PUBLIC 
"-//Sun Microsystems, Inc.//DTD Web Application 2.2//EN" 
"http: //java.sun.com/j2ee/dtds/web-app_2_2.dtd"> 


| 
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文档 类 型 定义 是 确保 文档 正确 的 一 个 重要 机 制 ， 但 是 它 不 是 必需 的 。 我 们 将 在 本 章 的 后 
面 讨论 这 个 问题 。 
最 后 ，XML 文档 的 正文 包含 根 元 素 ， 根 元 素 包 含 其 他 元 素 。 例 如 : 


<?xml version="1.0"?> 
<!DOCTYPE configuration. . .> 
<confi guration> 
<title> 
<font> 
<name>Hel veti ca</name> 
<Size>36</size> 
</font> 
</title> 
</configuration> 
TER WAT AK (child element)、 文 本 或 两 者 此 有 。 在 上 述 例子 中 ，font 元 素 有 两 个 
子 元 素 ， 它 们 是 name 和 size, name TAWA MA “Helvetica”, 


& 提示 : 在 设计 XML 文档 结构 时 ， 最 好 让 元 素 要 么 包含 子 元 素 ， 要 么 包含 文本 。 换 句 话 
说 ， 你 应 该 避免 下 面 的 情况 : 


<font> 
Helvetica 
<size>36</size> 
</font> 


在 XML 规范 中 ， 这 叫做 混合 式 内 容 (mixed content)。 在 本 章 中 ， 稍 后 你 将 会 看 到 ， 如 
果 避 免 了 混合 式 内 容 ， 就 可 以 简化 解析 过 程 。 
XML 元 素 可 以 包含 属性 ， 例 如 : 


<size unit="pt">36</size> 

何 时 用 元 素 ， 何 时 用 属性 ， 在 XML 设计 人 员 中 存在 一 些 分 歧 。 例 如 ， 将 Font 做 如 下 
描述 : 

<font name="Helvetica" size="36"/> 
似乎 比 下 面 的 描述 更 简单 一 些 : 


<font> 
<name>Helvetica</name> 
<Size>360</size> 
</font> 


但 是 ， 属 性 的 灵活 性 要 差 很 多 。 假 设 你 想 把 单位 添加 到 size 的 值 中 去 ， 如 果 使 用 属性 ， 那 么 
就 必须 把 单位 添加 到 属性 值 中 去 : 

<font name="Helvetica" size="36 pt"/> 

WE! 现在 必须 对 字符 串 “36 pt” 进 行 解析 ， 而 这 正 是 XML 被 设计 用 来 避免 的 那 种 麻烦 。 
而 向 size 元 素 中 添加 一 个 属性 看 起 来 会 清晰 得 多 : 
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<font> 
<name>Hel veti ca</name> 
<size unit="pt">36</size> 
</font> 


一 条 常用 的 经 验 法 则 是 ， 属 性 只 应 该 用 来 修改 值 的 解释 ， 而 不 是 用 来 指定 值 。 如 果 你 发 
现 自 己 陷 入 了 争论 ， 在 纠结 于 某 个 设置 是 否 是 对 某 个 值 的 解释 所 作 的 修改 ， 那 么 你 就 应 该 对 
属性 说 “不 ”， 转 而 使 用 元 素 ， 许 多 有 用 的 文档 根本 就 不 使 用 属性 。 
注意 : 在 HTML 中 ， 属 性 的 使 用 规则 很 简单 : 凡是 不 显示 在 网 页 上 的 都 是 属性 。 例 如 在 
下 面 的 超 链 接 中 : 
<a href="http://java.sun.com">Java Technology</a> 
字符 串 Java Technology 要 在 网 页 上 显示 ， 但 是 这 个 链接 的 URL 并 不 是 显示 页 面 
的 一 部 分 。 然 而 ， 这 个 规则 对 于 大 多 数 XML 并 不 那么 管用 ， 因 为 XML 文件 中 的 数据 并 
非 像 通 常 意义 那样 是 让 人 浏览 的 。 
元 素 和 文本 是 XML 文档 “主要 的 支撑 要 素 "， 你 可 能 还 会 遇 到 的 其 他 一 些 标记 ， 说 明 


如 下 : 
e 字符 引用 (character reference) 的 形式 是 &# 十 进 制 值 ; 或 &#x 十 六 进 制 值 ;。 例 如 ， 字 


符 6 可 以 用 下 面 两 种 形式 表示 : 
8#233; &#xE9; 
o 实体 引用 (entity reference) 的 形式 是 &name;。 下 面 这 些 实体 引用 : 
&lt; &gt; &amp; &quot; &apos; 
都 有 预定 义 的 含义 : DF. KF. &. SIS. BIS SS. BALE DTD HE 
义 其 他 的 实体 引用 。 

e CDATA 部 分 (CDATA Section) 用 <![CDATA[ 和 ]]> 来 限定 其 界限 。 它 们 是 字符 数据 
的 一 种 特殊 形式 。 你 可 以 使 用 它们 来 赛 括 那 些 含 有 <、>、 久 之 类 字符 的 字符 串 ， 而 不 
必 将 它们 解释 为 标记 ， 例 如 : 
<! [CDATA[< & > are my favorite delimiters]]> 

CDATA 部 分 不 能 包含 字符 串 ]]>。 使 用 这 一 特性 时 要 特别 小 心 ， 因 为 它 常 用 来 当 
作 将 遗留 数据 偷偷 纳入 XML 文档 的 一 个 后 门 。 

o 处 理 指令 ( processing instruction) 是 那些 专门 在 处 理 XML 文档 的 应 用 程序 中 使 用 的 指 
&, 它们 由 <? 和 ?> 来 限定 其 界限 ， 例 如: 
<?xml-stylesheet href="mystyle.css" type="text/css"?> 
每 个 XML 都 以 一 个 处 理 指令 开头 : 
<?xml version="1.0"?> 


o 注释 (comment) 用 <!- 和 --> 限定 其 界限 ， 例 如 : 


j 
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<!-- This is a comment. --> 
注释 不 应 该 含有 字符 串 --。 注 释 只 能 是 给 文档 的 读者 提供 的 信息 ， 其 中 绝 不 应 该 
含有 隐藏 的 命令 ,命令 应 该 是 用 处 理 指令 来 实现 。 


3.2 解析 XML 文档 


要 处 理 XML 文档 ， 就 要 先 解 析 (parse) 它 。 解 析 器 是 这 样 一 个 程序 . 它 读 入 一 个 文件 ， 
确认 这 个 文件 具有 正确 的 格式 ， 然 后 将 其 分 解 成 各 种 元 素 ， 使 得 程序 员 能 够 访问 这 些 元 素 。 
Java 库 提供 了 两 种 XML HENTAR : 

o 像 文 档 对 象 模型 (Document Object Model, DOM) 解析 器 这 样 的 树 型 解析 器 (tree 

parser)， 它 们 将 读 入 的 XML 文档 转换 成 树 结构 。 

o 像 XML 简单 API ( Simple API for XML, SAX) 解析 器 这 样 的 流 机 制 解 析 器 ( streaming 

parser)， 它 们 在 读 入 XML 文档 时 生成 相应 的 事件 。 

DOM 解析 需 对 于 实现 我 们 的 大 多 数目 的 来 说 都 更 容易 一 些 ， 所 以 我 们 首先 介绍 它 。 如 
果 你 要 人 处理 很 长 的 文档 ， 用 它 生 成 树 结构 将 会 消耗 大 量 内 存 ， 或 者 如 果 你 只 是 对 于 某 些 元 素 
感 兴趣 ， 而 不 关心 它们 的 上 上 下文， 那么 在 这 些 情 况 下 你 应 该 考虑 使 用 流 机 制 解析 器 。 更 多 的 

言 息 可 以 查看 3.6 节 。 

DOM fff OT ait AY Be A E A W3C 标准 化 了 。org.w3c.dom 包 中 包含 了 这 些 接口 类 型 的 
定义 ， 比 如 : Document 和 Element 等 。 不同 的 提供 者 ， 比 如 Apache 组 织 和 IBM， 都 编写 
了 实现 这 些 接口 的 DOM 解析 器 。Java XML 处 理 API ( Java API for XML Processing, JAXP) 
库 使 得 我 们 实际 上 可 以 以 插件 形式 使 用 这 些 解析 器 中 的 任意 一 个 。 但 是 IDK 中 也 包含 了 从 
Apache 解析 需 导 出 的 DOM HERTA o 

要 读 入 一 个 XML 文档 ， 首 先 需要 一 个 DocumentBui1der 对 象 ， 可 以 从 DocumentBui1der 
Factory 中 得 到 这 个 对 象 ， 例 如 : 


DocumentBuilderFactory factory = DocumentBuilderFactory.newInstance() ; 
DocumentBuilder builder = factory.newDocumentBuilder(); 


现在 ， 可 以 从 文件 中 读 和 人 茶 个 文档 : 


File f =. . 
Document doc = builder.parse(f) ; 


或 者 ， 可 以 用 一 个 URL: 


URL u=... 
Document doc = builder.parse(u) ; 


甚至 可 以 指定 一 个 任意 的 输入 流 : 


InputStream in=... 
Document doc = builder. parse(in); 


注意 : 如 果 使 用 输入 流 作 为 输入 源 ， 那 么 对 于 那些 以 该 文档 的 位 置 为 相对 路 径 而 被 引用 


华 


83% XML 123 


的 文档 ， 解 析 器 将 无 法 定位 ， 比 如 在 同一 个 目录 中 的 DTD。 但 是 ， 可 以 通过 安装 一 个 
“实体 解析 器 ”( entity resolver) 来 解决 这 个 问题 。 请 查看 www.xml.com/pub/a/2004/03/03/ 
catalogs.html 或 www.ibm.com/developerworks/xml/library/x-mxd3.html， 以 了 解 更 多 信息 。 


Document 对 象 是 XML 文档 的 树 型 结构 在 内 存 中 的 表示 方式 ， 它 由 实现 了 Node 接口 及 
其 各 种 子 接口 的 类 的 对 象 构 成 。 图 3-1 显示 了 各 个 子 接口 的 层次 结构 。 
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图 3-1 Node 接口 及 其 子 接口 
可 以 通过 调用 getDocumentE1ement 方法 来 启动 对 文档 内 容 的 分 析 ， 它 将 返回 根 元 素 。 


Element root = doc,getDocumentE1ement() ; 


例如 ， 如 果 要 处 理 下 面 的 文档 : 


<?xml version="1.0"?> 

<font> 

atos 

那么 ， 调 用 getDocumentE1ement 方法 可 以 返回 font 元 素 。getTagName 方法 可 以 返 
回 元 素 的 标签 名 。 在 前 面 这 个 例子 中 ，root .getTagName( ) 返回 字符 串 "font", 

如 果 要 得 到 该 元 素 的 子 元 素 (可 能 是 子 元 素 、 文 本 、 注 释 或 其 他 节点 ) 请 使 用 
getChildNodes 方法 ， 这 个 方法 会 返回 一 个 类 型 为 NodeList 的 集合 。 这 个 类 型 在 标准 的 
Java 集合 类 创建 之 前 就 已 经 被 标准 化 了 ， 因 此 它 具有 一 种 不 同 的 访问 协议 ; item 方法 将 得 
到 指定 索引 值 的 项 ; getLength 方法 则 提供 了 项 的 总 数 。 因 此 ， 我 们 可 以 像 下 面 这 样 枚 举 所 
ATIR: 
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NodeList children = root.getChildNodes(); 
for (int i = 0; i < children.getLength(); i++) 
{ 

Node child = children.item(i); 


} 
分 析 子 元 素 时 要 很 仔细 。 例 如 ， 假 设 你 正在 处 理 以 下 文档 : 
<font> 
<name>Hel veti ca</name> 
<Size>36</size> 
</font> 


你 预期 font 有 两 个 子 元 素 ， 但 是 解析 器 却 报告 说 有 5 个 : 
e <font> FI <name> 之 间 的 空白 字符 


e name 元 素 
e</name> FI <size> 之 间 的 空白 字符 
e size 元 素 


e </size> fil </font> 之 间 的 空白 字符 
图 3-2 显示 了 其 DOM 树 。 





图 3-2 一 棵 简单 的 DOM 树 
如 果 只 希望 得 到 子 元 素 ， 那 么 可 以 忽略 空白 字符 : 
for (int i = 0; i < children.getLength(); i++) 


Node child = children.item(i); 
if (child instanceof Element) 


{ 
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Element childElement = (Element) child; 


a 
} 


现在 ， 只 会 看 到 两 个 元 素 ， 它 们 的 标签 名 是 name 和 size. 

正如 将 在 下 一 节 中 所 看 到 的 那样 ， 如 果 你 的 文档 有 DTD， 那 么 你 就 可 以 做 得 更 好 。 这 
时 ， 解 析 器 知道 哪些 元 素 没 有 文本 节点 的 子 元 素 ， 而 且 它 会 帮 你 剔除 空 日 字符 。 

在 分 析 name 和 size 元 素 时 ,你 肯定 想 获取 它们 包含 的 文本 字符 串 。 这 些 文本 字符 串 
本 身 都 包含 在 Text 类 型 的 子 节点 中 。 既 然 知道 了 这 些 Text 节点 是 唯一 的 子 元 素 ， 吕 可 以 
用 getFirstChild 方 法 而 不 用 再 遍历 男 一 个 NodeList。 然 后 可 以 用 getData 方法 获取 存 
储 在 Text 节点 中 的 字符 串 。 


for (int i = 0; i < children.getLengthQ); i++) 


Node child = children.item(i); 
if (child instanceof Element) 
{ 
Element childElement = (Element) child; 
Text textNode = (Text) childElement.getFirstChild(); 
String text = textNode.getData().trim() ; 
if (childElement.getTagName() .equals ("name") ) 
name = text; 
else if (childElement.getTagName() .equals("size")) 
size = Integer.parselnt (text) ; 
} 
} 


& 提示 : 对 getData 的 返回 值 调 用 trim 方法 是 个 好 主意 。 如 果 XML 文件 的 作者 将 起 始 
和 结束 的 标签 放 在 不 同 的 行 上 ， 例 如 : 


<$1Ze@> 
36 
</size> 


那么 ， 解 析 器 将 会 把 所 有 的 换行 符 和 空格 都 包含 到 文本 节点 中 去 。 调 用 trim 方法 可 以 

把 位 于 实际 数据 前 后 的 空白 字符 删 掉 。 

也 可 以 用 getLastchild 方 法 得 到 最 后 一 项 子 元 素 ， 用 getNextSibling 得 到 下 一 个 
兄弟 节点 。 这 样 ， 另 一 种 遍历 子 节点 集 的 方法 就 是 : 


for (Node childNode = element.getFirstChild(); 
childNode != null; 
childNode = childNode.getNextSibling()) 
{ 
} 
如 果 要 枚 举 节点 的 属性 ， 可 以 调用 getAttributes 方法 。 它 返回 一 个 NamedNodeMap 对 
象 ， 其 中 包含 了 描述 属性 的 Node 对 象 。 可 以 用 和 遍历 NodeList 一 样 的 方式 在 NamedNodeMap 
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中 遍历 各 子 节 上 点。 然后， 调用 getNodeName 和 getNodeValue 方法 可 以 得 到 属性 名 和 属性 值 。 


NamedNodeMap attributes = element.getAttributes(); 
for (int 1 = 0; 1 < attributes.getLength(); i++) 


Node attribute = attributes.item(i); 
String name = attribute. getNodeName() ; 
String value = attribute. getNodeValue() ; 


} 
或 者 ， 如 果 知 道 属性 名 ， 则 可 以 直接 获取 相应 的 属性 值 : 
String unit = element,getAttribute("unit"); E DOMT ee Tes 


现在 你 已 经 知道 怎么 分 析 DOM 树 了 。 程 序 清 Breew 
单 3-1 中 的 程序 将 这 些 技术 都 运用 了 一 遍 。 你 可 以 oog 
使 用 File -> Open 菜单 选项 来 读 入 一 个 XML 文件 。 上 加 Text \n\n 


m D Comment: You can add a “home” attribute to represent th 
| 
| 


verbosityL... INFORMA... 





DocumentBui lder 对 象 会 解析 这 个 XML 文件 ， 并 产 


O Text: An 


生 一 个 Document 对 象 。 该 程序 会 将 Document 对 象 + p- Bement ConteaManager oa 
显示 为 一 个 JTree (参见 图 3-3 Jo i \n\n 
7A 5 = sia ee | F LJ Comment: 
该 树 形 结构 清楚 地 显示 了 子 元 素 是 怎样 被 包含 空 -Tree ww 


| L [ Comment: \n Comextinterceptor className ="org 


白字 符 和 注释 的 文本 包围 起 来 的 。 为 了 更 清楚 起 见 ， | Drwm in | 
这 个 程序 将 换行 和 回 车 字符 显示 为 \n 和 \r。( 否 则 ， | ana aaae gaei 
它们 将 显示 为 空 杠 ， 这 是 Swing 对 字符 串 中 不 能 绘制 
的 字符 显示 的 默认 符号 )。 图 3-3 ”一 押 XML 文档 的 解析 树 
在 第 10 章 你 将 会 学 习 到 该 程序 中 用 来 显示 树 形 结 构 和 属性 表 的 技术 。DOMTreeMode1 
类 实现 了 TreeModel 接口 。getRoot 方法 会 返回 文档 的 根 元 素 ，getChi1d 方法 可 以 得 到 
子 元 素 的 节点 列表 ， 返 回 被 请 求 的 索引 值 对 应 的 项 。 表 的 单元 格 演 染 器 显示 了 以 下 内 容 : 
o 对 元 素 ， 显 示 的 是 元 素 标签 名 和 由 所 有 的 属性 构成 的 一 张 表 。 
o 对 字符 数据 ， 显 示 的 是 接口 (Text、Comment 、CDATASection)， 后 面 跟着 数据 ， 其 
中 换行 和 回 车 字符 被 \n 和 \r 取代 。 
e 对 其 他 所 有 的 节点 类 型 ， 显示 的 是 类 名 ， 后 面 跟着 toString 的 结果 。 











package dom; 


import java.awt.*; 
import java.i0.*; 


import javax.swing.*; 

import javax.swing.event.*; 
import javax.swing.table.*; 
import javax.swing.tree.*; 
import javax.xm].parsers.*; 


AD oo ~ Cn Am 会 wu N e 


a p 
e O 





import org.w3c.dom. *; 
import org.w3c.dom.CharacterData; 


/ 


ek 


* This program displays an XML document as a tree. 
* @version 1.13 2016-04-27 
* @author Cay Horstmann 


i 
public class TreeViewer 
{ 
public static void main(String[] args) 
{ 
EventQueue.invokeLater(() -> 
{ 
JFrame frame = new DOMTreeFrame() ; 
frame.setTitle("TreeViewer"); 
frame. setDefaul tCloseOperation(JFrame.EXIT_ON_CLOSE) ; 
frame. setVisible(true) ; 
让 
} 
} 
/** 


€ 


{ 


* This frame contains a tree that displays the contents of an XML document. 
*/ 


lass DOMTreeFrame extends JFrame 


private static final int DEFAULT_WIDTH = 400; 
private static final int DEFAULT_HEIGHT = 400; 


private DocumentBuilder builder; 


public DOMTreeFrame() 


{ 
setSize(DEFAULT_WIDTH, DEFAULT_HEICHT) ; 


JMenu fileMenu = new JMenu("File"); 

JMenuItem openItem = new JMenuItem("Qpen") ; 
openItem.addActionListener(event -> openFile()); 
fileMenu.add(openItem) ; 


JMenuItem exitItem = new JMenuItem("Exit"); 
exitItem.addActionListener(event -> System.exit(0)); 
fi leMenu.add(exitItem) ; 


JMenuBar menuBar = new JMenuBar(); 
menuBar.add(fi |] eMenu) ; 
set)MenuBar (menuBar) ; 


} 


/** 


* Qpen a file and load the document. 
党 


public void openFile() 
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66 { 

67 JFileChooser chooser = new JFileChooser(); 

68 chooser. setCurrentDirectory(new File("dom")); 

69 chooser. setFileFilter( 

70 new javax. swing. fi lechooser.FileNameExtensionFilter("XML files", "xm]")); 
71 int r = chooser.showOpenDialog(this) ; 

n if (r != JFileChooser.APPROVE_OPTION) return; 

73 final File file = chooser.getSelectedFile(); 

74 

75 new SwingWorker<Document, Void>() 

76 { 

77 protected Document doInBackground() throws Exception 
78 

79 if (builder == null) 

80 { 

81 DocumentBuilderFactory factory = DocumentBuilderFactory.newInstance(); 
82 builder = factory.newDocumentBui Ider () ; 

83 } 

84 return builder. parse(file) ; 

85 } 

86 

87 protected void done() 

88 { 

89 try 

90 { 

91 Document doc = get(); 

92 JTree tree = new JTree(new DOMTreeModel (doc)) ; 
93 tree, setCel]Renderer(new DOMTreeCel]Renderer()); 
94 

95 setContentPane(new JScrol|Pane(tree)) ; 

96 validate(); 

97 } 

98 catch (Exception e) 

99 

100 JOptionPane. showMessageDialog(DOMTreeFrame.this, e); 
101 } 

102 

103 }.execute(); 

104 

105 } 

106 

107 /** 

108 * This tree model describes the tree structure of an XML document. 
109 */ 

110 Class DOMTreeModel implements TreeModel 

in { 


112 private Document doc; 


u /** 
115 * Constructs a document tree model. 
116 * @param doc the document 


117 */ 
118 public DOMTreeModel (Document doc) 
119 { 





一 


20 
121 
122 
123 
124 
125 
126 
127 
128 
129 
130 
131 
132 
133 
134 
135 
136 
137 
138 
139 
140 
141 
142 
143 
144 
145 
146 
147 
148 
149 
150 
151 
152 
153 
154 
155 
156 
157 
158 
159 } 
160 


161 /** 
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this.doc = doc; 


} 


public Object getRoot () 
{ 


return doc.getDocumentE]ement () ; 


} 
public int getChildCount (Object parent) 


Node node = (Node) parent; 
NodeList list = node.getChildNodes() ; 
return list.getLengthQ; 

} 


public Object getChild(Object parent, int index) 


Node node = (Node) parent; 
NodeList list = node. getChildNodes() ; 
return list.item(index) ; 


} 


public int getIndex0fChild(Object parent, Object child) 
{ 
Node node = (Node) parent; 
NodeList list = node.getChildNodes() ; 
for (int i = 0; i < list.getLengthQ); i++) 
if (getChild(node, 1) == child) return 7; 
return -1; 


} 
public boolean isLeaf (Object node) 


return getChildCount(node) == 0; 
} 


public void valueForPathChanged(TreePath path, Object newValue) {} 
public void addTreeModelListener(TreeModelListener 1) {} 
public void removeTreeModelListener(TreeModelListener 1) {} 


162 * This class renders an XML node. 


163 */ 


164 Class DOMTreeCellRenderer extends DefaultTreeCel]Renderer 


165 { 


public Component getTreeCel]RendererComponent(JTree tree, Object value, boolean selected, 
boolean expanded, boolean leaf, int row, boolean hasFocus) 
{ 


Node node = (Node) value; 
if (node instanceof Element) return elementPanel ((Element) node); 


super.getTreeCel]RendererComponent(tree, value, selected, expanded, leaf, row, hasFocus); 
if (node instanceof CharacterData) setText(characterString((CharacterData) node)); 


129 
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174 else setText(node.getClass() + ": " + node.toString()); 
175 return this; 
6 } 


178 public static JPanel elementPanel (Element e) 


179 { 

180 JPanel panel = new JPanel (); 

181 panel.add(new JLabel("Element: " + e.getTagName())) ; 

182 final NamedNodeMap map = e.getAttributes(); 

183 panel.add(new JTable(new AbstractTabl eModel () 

184 { 

185 public int getRowCount () 

186 { 

187 return map.getLength() ; 

188 

189 

190 public int getColumnCount () 

191 { 

192 return 2; 

193 } 

194 

195 public Object getValueAt(int r, int c) 

196 { 

197 return c == 0 ? map.item(r).getNodeName() : map.item(r).getNodeValue() ; 
198 } 

199 })); 

200 return panel; 

201 } 

202 

203 private static String characterString(CharacterData node) 

24 1 

205 StringBuilder builder = new StringBuilder(node.getData()); 
206 for (int 1 = 0; i < builder. length(); i++) 

207 { 

208 if (builder.charAt(i) == '\r') 

209 

210 builder.replace(i, 1 +1, “\\r"); 

211 i++} 

212 } 

213 else if (builder.charAt(i) == '\n') 

214 

215 builder.replace(i, 1 + 1, "\\n"); 

216 i++} 

217 } 

218 else if (builder.charAt(i) == '\t') 

219 { 

220 builder.replace(i, 1 +1, "\\t"); 

221 i++} 

222 } 

223 

224 if (node instanceof CDATASection) builder.insert(0, "CDATASection: "); 
225 else if (node instanceof Text) builder.insert(0, "Text: "); 
226 else if (node instanceof Comment) builder. insert(0, "Comment: "); 
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228 return builder.toString(); 





e static DocumentBuilderFactory newInstance( ) 
返回 DocumentBui lderFactory 类 的 一 个 实例 。 

e DocumentBuilder newDocumentBui lder() 
返回 DocumentBui Ider 类 的 一 个 实例 。 





e Document parse(File f) 


e Document parse(String url) 


e Document parse(InputStream in) 


解析 来 自给 定 文件 、URL 或 输入 流 的 XML SCH, 1 EATE BCA 





è Element getDocumentE1ement( ) 


返回 文档 的 根 元 素 。 


e String getTagName( ) 


返回 元 素 的 名 字 。 
e String getAttribute(String name) 
返回 给 定名 字 的 属性 值 ， 没 有 该 属性 时 返回 空 字符 串 。 


e NodeList getChildNodes() 
返回 包含 该 节点 所 有 子 元 素 的 节点 列表 。 
e Node getFirstChild() 
e Node getLastChild() 
获取 该 节点 的 第 一 个 或 最 后 一 个 子 节点 ， 在 该 节点 没有 子 节 点 时 返回 null, 
e Node getNextSibling() 
e Node getPreviousSibling( ) 


获取 该 节点 的 下 一 个 或 上 一 个 兄弟 节点 ， 在 该 节点 没有 兄弟 节点 时 返回 nu11。 
e Node getParentNode( ) 


PRAIA AAS, FETA ESO YT [A] nu11。 
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e NamedNodeMap getAttributes() 

返回 含有 描述 该 节点 所 有 属性 的 Attr 节点 的 映射 表 。 
e String getNodeName( ) 

返回 该 节点 的 名 字 。 当 该 节点 是 Attr 节点 时 ， 该 名 字 就 是 属性 名 。 
e String getNodeValue( ) 


返回 该 节点 的 值 。 当 该 节点 是 Attr 节点 时 ， 该 值 就 是 属性 值 。 








e String getData() 
返回 存储 在 节点 中 的 文本 。 





èe int getLength() 
返回 列表 中 的 节点 数 。 


e Node item(int index) 


返回 给 定 索引 值 处 的 节点 。 索 引 值 范围 在 0 到 getLength( )-1 之 间 。 





e int getLength() 
返回 该 节点 映射 表 中 的 节点 数 。 
e Node item(int index) 


返回 给 定 索 引 值 处 的 节点 。 索 引 值 范围 在 0 到 getLength( )-1 之 间 。 


3.3 ”验证 XML 文档 


在 前 一 节 中 ， 我 们 了 解 了 如 何 遍 历 DOM 文档 的 树 形 结构 。 然 而 ， 如 果 仅 仅 按照 这 种 方 
法 来 操作 ， 会 发 现 需要 大 量 宛 长 的 编程 和 错误 检查 工作 。 你 不 但 需要 处 理 元 素 间 的 空 日 字 
符 ， 还 要 检查 该 文档 包含 的 节点 是 否 和 你 期 望 的 一 样 。 例 如 ， 当 你 在 读 人 下 面 这 个 元 系 时 : 


<font> 
<name>Hel veti ca</name> 
<$1Ze>36</S1zZe> 
</font> 


CORP CTS BAT, ROE PAA SFE “Nn” ASAT R MIKELE H 
点 找到 第 一 个 元 素 节点 。 然 后 ， 你 要 检查 它 的 标签 名 是 不 是 “ name”， 还 要 检查 它 是 否 有 一 
个 Text 类 型 的 子 节点 。 接 下 来 ， 转 到 下 一 个 非 空 白字 符 的 子 节 扣 ， 并 进行 同样 的 检查 。 那 
么 ， 当 文档 作者 改变 了 子 元 素 的 顺序 或 是 加 入 另 一 个 子 元 素 时 又 会 怎样 呢 ? 要 是 对 所 有 的 错 
误 检 查 都 进行 编码 ， 就 会 显得 太 琐碎 习 烦 了 ， 而 跳 过 这 些 检查 又 显得 不 慎重 。 


华 
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幸好 ，XML 解析 器 的 一 个 很 大 的 好 处 就 是 它 能 自动 校 验 某 个 文档 是 否 具有 正确 的 结构 。 
这 样 ， 解 析 就 变 得 简单 多 了 。 例 如 ， 如 果 知 道 font 片段 已 经 通过 了 了 验 证， 那么 你 不 用 进 一 
步 检查 就 能 得 到 其 两 个 孙 节 点 ， 并 把 它们 转换 成 Text 节点 ， 得 到 它们 的 文本 数据 。 

如 果 要 指定 文档 结构 ， 可 以 提供 一 个 文档 类 型 定义 (DTD) 或 一 个 XML Schema 定义 。 
DTD 或 schema 包含 了 用 于 解释 文档 应 如 何 构 成 的 规则 ， 这 些 规则 指定 了 每 个 元 素 的 合法 子 
TUR ABE. flan, FES DTD 可 能 含有 一 项 规则 : 

<!ELEMENT font (name,size)> 

这 项 规则 表示 ， 一 个 font 元 素 必须 总 是 有 两 个 子 元 素 ， 分 别 是 name 和 size。 将 同样 
的 约束 用 XML Schema 表示 如 下 : 


<xsd:element name="font"> 
<xsd: Sequence> 
<xsd:element name="name" type="xsd:string'/> 
<xsd:element name="size’ type="xsd:int'/> 
</xsd: Sequence> 
</xsd:e]lement> 


与 DTD #HEK, XML Schema 可 以 表达 更 加 复杂 的 验证 条 件 (比如 size 元 素 必 须 包含 一 
个 整数 )。 与 DTD 语法 不 同 ，XML Schema 自身 使 用 的 就 是 XML ， 这 为 处 理 Schema 文件 市 
来 了 方便 。 

在 下 一 节 中 ， 我 们 将 详细 讨论 DTD。 接 着 简要 介绍 XML Schema 的 一 些 基础 知识 。 最 
后 ， 我 们 会 展示 一 个 完整 的 应 用 程序 来 演示 验证 是 如 何 简化 XML 编程 的 。 


3.3.1 文档 类 型 定义 
提供 DTD 的 方式 有 多 种 。 可 以 像 下 面 这 样 将 其 纳入 到 XML 文档 中 : 


<?xml version="1.0"?> 

<!DOCTYPE configuration [ 
<!ELEMENT configuration. . .> 
more rules 


n ki 


<configuration> 

</configuration> 

正如 你 看 到 的 ， 这 些 规 则 被 纳入 到 DOCTYPE 声明 中 ， 位 于 由 [...] 限 定 界 限 的 块 中 。 
文档 类 型 必须 匹配 根 元 素 的 名 字 ， 比 如 我 们 例子 中 的 configuration, 

在 XML 文档 内 部 提供 DTD 不 是 很 普遍 ， 因 为 DTD 会 使 文件 长 度 变 得 很 长 。 把 DTD FF 
储 在 外 部 会 更 具 意 义 ，SYSTEM 声明 可 以 用 来 实现 这 个 目标 。 你 可 以 指定 一 个 包含 DTD 的 
URL, 例如: 

<!DOCTYPE configuration SYSTEM "config.dtd"> 
或 者 
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<!DOCTYPE configuration SYSTEM "http://myserver.com/config.dtd"> 

警告 : 如 果 你 使 用 的 是 DTD 的 相对 URL (比如 "config.dtd")， 那 么 要 给 解析 器 一 个 
File 或 URL 对 象 ， 而 不 是 InputStream。 如 果 必 须 从 一 个 输入 流 来 解析 ， 那 么 请 提供 
一 个 实体 解析 器 (请 看 下 面 的 说 明 )。 


最 后 ， 有 一 个 来 源 于 SGML 的 用 于 识别 “众所周知 的 ”DTD 的 机 制 ， 下 面 是 一 个 例子 : 


<!DOCTYPE web-app 
PUBLIC "-//Sun Microsystems, Inc.//DTD Web Application 2.2//EN" 
"http: //java. sun. com/j2ee/dtds/web-app_2_2.dtd"> 


如 果 XML 处 理 器 知道 如 何 定位 带 有 公共 标识 符 的 DID ， 那 么 就 不 需要 URL 了 。 

$B: 如 果 你 使 用 的 是 DOM 解析 器 ， 并 且 想 要 支持 PUBLIC 标识 符 ， 请 调用 
DocumentBuilder 类 的 setEntityResolver 方法 来 安装 EntityResolver 接口 的 某 
个 实现 类 的 一 个 对 象 。 该 接口 只 有 一 个 方法 : resolveEntity。 下 面 是 一 个 典型 实现 的 
代码 框架 : 

class MyEntityResolver implements EntityResolver 


public InputSource resolveEntity(String publicID, String systemID) 


if (publicID.equals(a known ID)) 
return new InputSource(DTD data) ; 
else 
return null; // use default behavior 
} 


} 
你 可 以 从 InputStream, Reader 或 字符 串 中 构建 输入 源 。 


既然 你 已 经 知道 解析 器 怎样 定位 DTD 了， 那么 下 面 就 让 我 们 来 看 看 不 同类 型 的 规则 。 
ELEMENT 规则 用 于 指定 某 个 元 素 可 以 拥有 什么 样 的 子 元 素 。 可 以 指定 一 个 正则 表达 式 ， 


它 由 表 3-1 中 所 示 的 组 成 部 分 构成 。 


表 3-1 用 于 元 素 内 容 的 规则 





规 m a 义 
E* 0 或 多 个 E 
E+ 1 或 多 个 EE 
E? 0 或 1 个 EE 
BIE) sc «|B a E, 中 的 一 个 
N E, E, 后 面 跟着 已, . . . ,已 
#PCDATA 文本 
(#PCDATAIE,|E,| .. . |E,)* 0 或 多 个 文本 且 E, E.. E, 以 任意 顺序 排列 (混合 式 内 容 ) 
ANY 允许 有 任意 子 元 素 
EMPTY 不 允许 有 子 元 素 
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下 面 是 一 些 简单 而 典型 的 例子 。 下 面 的 规则 声明 了 menu 元 素 包含 0 或 多 个 item 元 素 : 
<!ELEMENT menu (item)*> 
下 面 这 组 规则 声明 Font 是 用 一 个 name 后 跟 一 个 size 来 描述 的 ， 它 们 都 包含 文本 : 


<!ELEMENT font (name,size)> 
<!ELEMENT name (#PCDATA) > 
<!ELEMENT size (#PCDATA) > 


缩写 PCDATA 表示 被 解析 的 字符 数据 。 这 些 数据 之 所 以 被 称 为 “被 解析 的 ”是 因为 解析 
器 通过 寻找 表示 一 个 新 标签 起 始 的 < 字符 或 表示 一 个 实体 起 始 的 文字 符 , 来 解释 这 些 文 本 字 
符 串 。 

元 素 的 规格 说 明 可 以 包含 嵌 套 的 和 复杂 的 正则 表达 式 ， 例 如 ， 下 面 是 一 个 描述 了 本 书 中 
每 一 章 的 结构 的 规则 : 

<!ELEMENT chapter (intro, (heading, (para|image|table|note)+)+) 

每 章 都 以 简介 开头 ， 其 后 是 1 或 多 个 小 节 ， 每 个 小 节 由 一 个 标题 和 1 个 或 多 个 段落 、 图 
片 、 表 格 或 说 明 构 成 。 

然而 ， 有 一 种 常见 的 情况 是 无 法 把 规则 定义 得 像 你 希望 的 那样 灵活 的 。 当 一 个 元 系 可 以 
包含 文本 时 ， 那 么 就 只 有 两 种 合法 的 情况 。 要 么 该 元 素 只 包含 文本 ， 比 如 : 

<!ELEMENT name (#PCDATA)> 
要 么 该 元 素 包 含 任 意 顺序 的 文本 和 标签 的 组 合 ， 比 如 : 

<!ELEMENT para (#PCDATA|em|strong|code)*> 
指定 其 他 任何 类 型 的 包含 #PCDATA 的 规则 都 是 不 合法 的 。 例 如 ， 以 下 规则 是 非法 的 : 

<!ELEMENT captionedImage (image,#PCDATA) > 
必须 重 写 这 项 规则 ， 以 引入 另 一 个 caption 元 素 或 者 允许 使 用 image 元 素 和 文本 的 任意 组 


Pas 
Ho 


这 种 限制 简化 了 XML 解析 器 在 解析 混合 式 内 容 (标签 和 文本 的 混合 ) 时 的 工作 。 因 为 在 
允许 使 用 混合 式 内 容 时 难免 会 失控 ， 所 以 最 好 在 设计 DTD 时 ， 让 其 中 所 有 的 元 素 要 人 么 包含 
其 他 元 素 ， 要 么 只 有 文本 。 


注意 : 实际 上 ， 在 DTD 规则 中 并 不 能 为 元 素 指定 任意 的 正则 表达 式 ，XML 解析 器 会 拒 
绝 某 些 导致 非 确定 性 的 复杂 规则 。 人 例如， 正则 表达 式 ((x,y)|(x,z)) 就 是 非 确 定性 的 。 
当 解 析 器 看 到 x 时 ， 它 不 知道 在 两 个 选择 中 应 该 选取 哪 一 个 。 这 个 表达 式 可 以 改写 成 确 
定性 的 形式 ， 如 (x,(y|z))。 然 而 ， 有 一 些 表 达 式 不 能 被 改写 ， 如 ((x,y)*|x?)。Java 
XML 库 中 的 解析 器 在 遇 到 有 歧义 的 DTD 时 ， 不 会 给 出 警告 。 在 解析 时 ， 它 仅仅 在 两 者 
中 选取 第 一 个 匹配 项 ， 这 将 导致 它 会 拒绝 一 些 正确 的 输入 。 当 然 ， 解析 器 有 权 这 么 做 ， 
因为 XML 标准 允许 解析 器 假设 DTD 都 是 非 二 义 性 的 。 在 实际 应 用 中 ， 这 不 是 一 个 会 让 
你 睡 不 着 觉 的 问题 ， 因 为 大 多 数 DTD 都 非常 简单 ， 根 本 不 会 遇 上 二 义 性 问题 。 


j 
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还 可 以 指定 描述 合法 的 元 素 属 性 的 规则 ， 其 通用 语法 为 : 
<!ATTLIST element attribute type default> 


表 3-2 显示 了 合法 的 属性 类 型 (type)， 表 3-3 显示 了 属性 默认 值 (default) 的 语法 。 


表 3-2 属性 类 型 

类 型 含 X 
CDATA 任意 字符 串 
(A||A)| . . . JAn) PF BIBLE A, A... Ar 之 一 
NMTOKEN NMTOKENS 1 或 多 个 名 字 标 记 
ID 1 个 唯一 的 ID 
IDREF IDREFS 1 或 多 个 对 唯一 ID 的 引用 
ENTITY ENTITIES 1 或 多 个 未 解析 的 实体 


表 3-3 属性 的 默认 值 


默认 值 含义 

#REQUIRED 属性 是 必需 的 

#IMPLIED 属性 是 可 选 的 

4 属性 是 可 选 的 ; 若 未 指定 ， 解 析 器 报告 的 属性 是 4 

#FIXED 4 属性 必须 是 未 指定 的 或 者 是 4; 在 这 两 种 情况 下 ， 解 析 器 报告 的 属性 都 是 4 
以 下 是 两 个 典型 的 属性 规格 说 明 : 


<!ATTLIST font style (plain|bold|italic|bold-italic) "plain"> 
<!ATTLIST size unit CDATA #IMPLIED> 


第 一 个 规格 说 明 描 述 了 font 元 素 的 style 属性 。 它 有 4 个 合法 的 属性 值 ， 默 认 值 是 
plain。 第 二 个 规格 说 明 表 示 size 元 素 的 unit 属性 可 以 包含 任意 的 字符 数据 序列 。 


注意 : 一 般 情 况 下 ， 我 们 推荐 用 元 素 而 非 属 性 来 描述 数据 。 按 照 这 个 推荐 ，font style 应 
该 是 一 个 独立 的 元 素 ， 例 如 《font><style>p1l1ain</sty1e>...</font>。 然 而 ， 对 于 
枚 举 类 型 ， 属 性 有 一 个 不 可 否认 的 优点 ， 那 就 是 解析 器 能 够 校 验 其 取 值 是 否 合法 。 例 如 ， 
如 果 font style 是 一 个 属性 ， 那 么 解析 器 就 会 检查 它 是 不 是 4 个 允许 的 值 之 一 ， 并 且 如 果 
没有 为 其 提供 属性 值 ， 那 么 解析 器 还 会 为 其 提供 一 个 默认 值 。 


CDATA 属性 值 的 处 理 与 你 前 面 看 到 的 对 #PCDATA 的 处 理 有 着 微妙 的 差别 ， 并 且 与 
<![CDATA[...]]> 部 分 没有 多 大 关系 。 属 性 值 首先 被 规范 化 ， 也 就 是 说 ， 解 析 器 要 先 处 理 
对 字符 和 实体 的 引用 (比如 &#233; 或 &1t;)， 并 且 要 用 空格 来 替换 空白 字符 。 

NMTOKEN ( 即 名 字 标 记 ) 与 CDATA 相似 , 但 是 大 多 数 非 字母 数字 字符 和 内 部 的 空白 字符 
是 不 允许 使 用 的 ， 而 且 解 析 器 会 删除 起 始 和 结尾 的 空白 字符 。NMTOKENS 是 一 个 以 空白 字符 
分 隔 的 名 字 标 记 列 表 。 

ID 结构 是 很 有 用 的 ，ID 是 在 文档 中 必须 唯一 的 名 字 标 记 ， 解 析 咒 会 检查 其 唯一 性 。 在 
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下 一 个 示例 程序 中 ， 你 会 看 到 它 的 应 用 。IDREF 是 对 同一 文档 中 已 存在 的 ID 的 引用 ,解析 
器 也 会 对 它 进行 检查 。IDREFS 是 以 空白 字符 分 隔 的 ID 引用 的 列表 。 

ENTITY 属性 值 将 引用 一 个 “未 解析 的 外 部 实体 ”。 这 是 从 SGML 那里 沿用 下 来 的 ,在 
实际 应 用 中 很 少见 到 。 在 http://www.xml.com/axml/axml.html 处 的 被 注解 的 XML 规范 中 有 该 
属性 的 一 个 例子 。 

DTD 也 可 以 定义 实体 ， 或 者 定义 解析 过 程 中 被 蔡 换 的 缩写 。 你 可 以 在 Firefox W) bi dir BY 
用 户 界面 描述 中 找到 一 个 很 好 的 使 用 实体 的 例子 。 这 些 描述 被 格式 化 为 XML 格式 ， 包 含 了 
如 下 的 实体 定义 : 

<!ENTITY back.]abel “Back > 

其 他 地 方 的 文本 可 以 包含 对 这 个 实体 的 引用 ， 例 如 : 

<menuitem label="&back. 1abel,"/> 

解析 器 会 用 替代 字符 串 来 替换 该 实体 引用 。 如 果 要 对 应 用 程序 进行 国际 化 处 理 ， 只 需 修 
改 实体 定义 中 的 字符 串 即 可 。 其 他 的 实体 使 用 方法 更 加 复杂 ， 且 不 太 常 用 ， 详 细 说 明 参 见 
XML 规范 。 

这 样 我 们 就 结束 了 对 DTD 的 介绍 。 既 然 你 已 经 知道 如 何 使 用 DTD 了， 那么 你 就 可 以 配 
置 你 的 解析 器 以 充分 利用 它们 了 。 首 先 ， 通 知 文档 生成 工厂 打开 验证 特性 。 

factory,SetValidating(true) ; 

这 样 ， 该 工厂 生成 的 所 有 文档 生成 器 都 将 根据 DTD 来 验证 它们 的 输入 。 验 证 的 最 大 好 
处 是 可 以 忽略 元 素 内 容 中 的 空白 字符 。 例 如 ， 考 虑 下 面 的 XML 代码 片段 : 


<font> 
<name>Hel veti ca</name> 
<51Ze>36</S1Ze> 
</font> 


一 个 不 进行 验证 的 解析 器 会 报告 font name 和 size 元 素 之 间 的 空白 字符 ， 因 为 它 无 
法 知道 font 的 子 元 素 是 : 


(name, size) 
(#PCDATA, name, size)* 


还 是 : 

ANY 
— H DTD 指定 了 子 元 素 是 (name,size)， 解 析 器 就 知道 它们 之 间 的 空 日 字符 不 是 文本 。 调 
用 下 面 的 代码 : 

factory,SetIgnoringElementContentWhitespace(true) ; 
这 样 ， 生 成 器 将 不 会 报告 文本 节点 中 的 空白 字符 。 这 意味 着 ， 你 可 以 依赖 font 斑点 拥有 2 
个 子 元 素 这 一 事实 。 你 再 也 不 用 编写 下 面 这 样 的 单调 元 长 的 循环 代码 了 : 


for (int i = 0; i < children.getLength(Q); i++) 
{ 
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Node child = children.item(i); 
if (child instanceof Element) 


Element childElement = (Element) child; 
if (childElement.getTagName().equals("name")) . . . 
else if (childElement.getTagName().equals("size")) ，，， 
} 
| 


而 只 和 需 仅 仅 通过 如 下 代码 访问 第 一 个 和 第 二 个 子 元 素 : 


Element nameElement = (Element) children.item(0); 
Element sizeElement = (Element) children.item(1); 


这 就 是 DID 如 此 有 用 的 原因 。 你 不 会 为 了 检查 规则 而 使 程序 负担 过 重 。 在 得 到 文档 之 
前 ， 解 析 需 已 经 做 完了 这 些 工 作 。 


O 提示 : 许多 刚 开 始 使 用 XML 的 程序 员 都 对 验证 不 习惯 ， 并 且 最 终 还 是 在 程序 运行 过 程 
中 分 析 DOM 树 。 如 果 要 说 服 你 的 同事 让 他 们 信服 使 用 验证 过 的 文档 所 带 来 的 好 处 ， 那 
么 就 给 他 们 看 上 述 两 种 不 同 的 编码 方式 ， 这 样 才 能 使 他 们 相信 你 。 


当 解 析 上 需 报 告 铺 误 时 ， 应 用 程序 希望 对 该 错误 执行 某 些 操作 。 人 例如， 记录 到 日 志 中 ， 把 
它 显示 给 用 户 ,或 是 抛 出 一 个 异常 以 放弃 解析 。 因 此 ， 只 要 使 用 验证 ， 就 应 该 安装 一 个 错误 
处 理 器 ， 这 需要 提供 一 个 实现 了 ErrorHandler 接口 的 对 象 。 这 个 接口 有 三 个 方法 : 


void warning(SAXParseException exception) 
void error(SAXParseException exception) 
void fatalError(SAXParseException exception) 


可 以 通过 DocumentBuilder 类 的 setErrorHandler 方法 来 安装 错误 处 理 器 : 


builder, setErrorHandler(handler): 





e void setEntityResolver(EntityResolver resolver) 


DORR DT At, RAE BR TAY XML 文档 中 引用 的 实体 。 


e void setErrorHandler(ErrorHandler handler) 


TSE A SR ESP EFE P St a E r AAE o 








e public InputSource resolveEntity(String publicID, String systemID) 
返回 一 个 输入 源 ， 它 包含 了 被 给 定 ID AS MB, Ba, SAR DT ARAN ALI ON fy fe TI 
个 特定 名 字 时 ， 返 回 nu11。 如 果 没 有 提供 公共 IDP， 那 么 参数 publicID 可 以 为 nu11。 





@ InputSource(InputStream in) 
e InputSource(Reader in) 
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e InputSource(String SystemID ) 
从 流 、 读 人 器 或 系统 ID (通常 是 相对 或 绝对 URL) 中 构建 输入 源 。 





e void fatalError(SAXParseException exception) 


e void error(SAXParseException exception) 
e void warning(SAXParseException exception) 


覆盖 这 些 方法 以 提供 对 致命 错误 、 非 致命 错误 和 警告 进行 处 理 的 处 理 右 。 





e int getLineNumber() 


e int getColumnNumber( ) 
返回 引起 异常 的 已 处 理 的 输入 信息 末尾 的 行 号 和 列 号 。 





e boolean isValidating() 


e void setValidating(boolean value) 
获取 和 设置 工厂 的 validating 属性 。 当 它 设 为 true 时 ， 该 工厂 生成 的 解析 器 会 验 
证 它们 的 输入 信息 。 

e boolean isIgnoringElementContentwhitespace( ) 

evoid setIgnoringElementContentWhitespace(boolean value) 
获取 和 设置 工厂 的 ignoringElementContentWhitespace 属性 。 当 它 设 为 true 
时 ， 该 工厂 生成 的 解析 器 会 忽略 不 含混 合 内 容 〈 即 ， 元 素 与 #PCDATA 混合 ) KURT 
点 之 间 的 空 日 字符 。 


3.3.2 XML Schema 


因为 XML Schema 比 起 DTD 语法 要 复杂 许多 ， 所 以 我 们 只 涉及 其 基本 知识 。 更 多 信息 
请 参考 http:Wwww.w3.org/TR/xmlschema-0 上 的 指南 。 
如 果 要 在 文档 中 引用 Schema 文件 ， 需 要 在 根 元 素 中 添加 属性 ， 例 如 : 


<?xml version="1.0"?> 
<configuration xmins:xsi="http://www.w3.org/2001/XMLSchema-instance" 
xsi :noNamespaceSchemaLocation="config.xsd"> 

</confi gurati on> 

这 个 声明 说 明 Schema 文件 config.xsd 会 被 用 来 验证 该 文档 。 如 果 使 用 命名 空间 ， 语 
法 就 更 加 复杂 了 。 详 情 请 参见 XML Schema 指南 (前 级 xsi 是 一 个 命名 空间 别名 (namespace 
alias)， 请 查看 第 3.5 节 以 了 解 更 多 信息 )。 

Schema 为 每 个 元 素 都 定义 了 类 型 。 类 型 可 以 是 简单 类 型 ， 即 有 格式 限制 的 字符 串 ， 或 者 
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是 复杂 类 型 。 一 些 简单 类 型 已 经 被 内 建 到 了 XML Schema 内 ， 包 括 ; 


xsd:string 
xsd:int 
xsd:boolean 


注意 : 我 们 用 前 级 xsd: RRA XSL Schema 定义 的 命名 空间 。 一 些 作 者 代 之 以 xs:。 
可 以 定义 自己 的 简单 类 型 。 例 如 ， 下 面 是 一 个 枚 举 类 型 . 


<xsd:simpleType name="StyleType"> 
<xsd:restriction base="xsd:string"> 
<xsd:enumeration value="PLAIN" /> 
<xsd:enumeration value="BOLD" /> 
<xsd:enumeration value="ITALIC" /> 
<xsd:enumeration value="BOLD ITALIC" /> 
</xsd:restriction> 
</xsd:simpleType> 


当 定 义 元 素 时 ， 要 指定 它 的 类 型 : 


<xsd:element name="name" type="xsd:string"/> 
<xsd:element name="size" type="xsd:int"/> 
<xsd:element name="style” type="StyleType"/> 


类 型 约束 了 元 素 的 内 容 。 例 如 ， 下 面 的 元 素 将 被 验证 为 具有 正确 格式 : 


<$ize>10</size> 
<style>PLAIN</style> 


但 是 ， 下 面 的 元 素 会 被 解析 器 拒绝 : 


<size>defaul t</size> 
<style>SLANTED</style> 


你 可 以 把 类 型 组 合成 复杂 类 型 ， 例 如 : 


<xsd:complexType name="FontType"> 
<xsd:sequence> 
<xsd:element ref="name"/> 
<xsd:element ref="size"/> 
<xsd:element ref="style"/> 
</xsd: Sequence> 
</xsd: comp] exType> 


FontType Æ name, size fil style 元 素 的 序列 。 在 这 个 类 型 定义 中 ， 我 们 使 用 了 ref 
属性 来 引用 在 Schema PAF RIAA. tha REE, BO: 


<xsd:complexType name="FontType"> 
<xsd: Sequence> 
<xsd:element name="name" type="xsd:string'/> 
<xsd:element name="size" type="xsd:int"/> 
<xsd:element name="style" type="StyleType"> 
<xsd:simpleType> 
<xsd:restriction base="xsd:string"> 
<xsd:enumeration value="PLAIN" /> 
<xsd:enumeration value="BOLD" /> 
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<xsd:enumeration value="ITALIC" /> 
<xsd:enumeration value="BOLD_ITALIC" /> 
</xsd:restriction> 
</xsd:simpleType> 
</xsd:element> 
</xsd:sequence> 
</xsd: comp] exType> 


请 注意 style 元 素 的 匿名 类 型 定义 。 
xsd:sequence 结构 和 DTD 中 的 连接 符号 等 价 ， 而 xsd:choice 结构 和 | 操作 符 等 价 ， 
例如 


<xsd:complexType name="contactinfo'> 
<xsd: choi ce> 
<xsd:element ref="email"/> 
<xsd:element ref="phone"/> 
</xsd:choice> 
</xsd:comp]exType> 


这 和 DTD 中 的 类 型 email | phone 类 型 是 等 价 的 。 

如 果 要 人 允许 重复 元 素 ， 可 以 使 用 minoccurs 和 maxoccurs 属性 ， 例 如 ， 与 DTD 类 型 
item* 等 价 的 形式 如 下 : 

<xsd:element name="item" type=". . ." minoccurs="0" maxoccurs="unbounded"> 

如 果 要 指定 属性 ， 可 以 把 xsd:attribute 元 素 添 加 到 complexType 定义 中 去 : 


<xsd:element name="size'> 
<xsd: comp] exType> 


<xsd:attribute name="unit" type="xsd:string” use="optional” default="cm"/> 
</xsd:comp|exType> 
</xsd:element> 


这 与 下 面 的 DTD 语句 等 价 : 
<!ATTLIST size unit CDATA #IMPLIED “cm > 
可 以 把 Schema 的 元 素 和 类 型 定义 封装 在 xsd: schema WAF: 


<xsd:schema xmlns:xsd="http://www.w3.0rg/2001/XMLSchema" > 


</xsd: schema> 

解析 带 有 Schema 的 XML 文件 和 解析 带 有 DTD 的 文件 相似 ， 但 有 3 点 差别 : 
1 ) 必须 打开 对 命名 空间 的 支持 ， 即 使 在 XML 文件 里 你 可 能 不 会 用 到 它 。 
factory. setNamespaceAware(true) ; 

2) HAHA FAY “ESC” KERA Schema WEJ - 


final String JAXP_SCHEMA LANGUAGE = "http://java.sun.com/xml/jaxp/properties/schemaLanguage’ ; 
final String W3C_XML_SCHEMA = "http: //www.w3.org/2001/XMLSchema" ; 
factory.setAttribute(JAXP_SCHEMA LANGUAGE, W3C_XML_SCHEMA) ; 


3) 解析 器 不 会 丢弃 元 素 中 的 空白 字符 ， 这 确实 很 令 人 恼火 ， 关 于 这 是 否 是 一 个 bug， 人 
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们 看 法 不 一 。 有 一 种 变通 方法 ， 请 参看 程序 清单 3-4 中 的 代码 。 
3.3.3 ”实用 示例 


在 本 市 中 ， 我们 将 要 介绍 一 个 实用 的 示例 程序 ， 用 来 说 明 在 实际 环境 中 XML 的 用 法 。 
请 回忆 一 下 卷 第 12 章 ，GridBagLayout 是 Swing 构件 中 最 有 用 的 布局 管理 器 。 然而， 人 
们 都 很 县 惧 它 ， 这 不 仅 是 因为 它 的 复杂 性 ， 还 因为 其 编码 宛 长 乏味 。 把 布局 描述 放 到 一 个 文 
本 文件 中 来 替代 大 量 重复 代码 将 会 带 来 很 大 便利 。 在 本 节 中 ， 你 将 看 到 怎样 用 XML 来 描述 
网 格 组 (grid bag) 布局 和 怎样 解析 布局 文件 。 

网 格 组 是 由 行 和 列 构成 的 ， 它 和 HTML 表格 非常 相似 。 与 HTML 表格 相似 的 是 ， 我 们 
把 它 描述 成 一 个 行 的 序列 ， 每 个 行 都 包含 若干 单元 格 : 


<gridbag> 

<row> 
<cell>. . .</cell> 
<cell>. . .</cell> 


</ roW> 

<row> 
<cell>. . .</cell> 
<cell>. . .</cell> 


dii 
</gridbag> 
gridbag.dtd 指定 了 以 下 规则 : 


<!ELEMENT gridbag (row)*> 
<!ELEMENT row (cell)*> 


有 些 单元 格 可 以 跨 多 行 多 列 。 在 网 格 组 布局 中 ， 这 是 通过 将 gridwidth 和 gridheight 
设置 为 大 于 1 的 值 来 实现 的 。 我 们 将 使 用 相同 的 名 字 作 为 属性 名 : 

<cell gridwidth="2" gridheight="2"> 

同样 ， 我 们 将 属性 应 用 于 网 格 组 的 其 他 约束 : fill, anchor, gridx, gridy, 
weightx、weighty、ipadx 和 ipady。( 我 们 不 处 理 insets 约束 ， 因 为 它 的 值 不 是 简单 类 
型 ,但 是 要 支持 它 也 是 很 简单 的 。) 例如 : 


<cell fill="HORIZONTAL" anchor="NORTH"> 
对 大 多 数 属性 ， 我 们 都 提供 了 与 为 ridBagConstraints 的 无 参 构造 器 所 提供 的 默认 
值 相同 的 默认 值 : 


<!ATTLIST cel] gridwidth CDATA "1"> 
<!ATTLIST cell gridheight CDATA "1"> 
<!ATTLIST cell fill (NONE|BOTH|HORIZONTAL|VERTICAL) "NONE"> 
<!ATTLIST cell anchor (CENTER|NORTH|NORTHEAST | EAST 
| SOUTHEAST | SOUTH | SOUTHWEST | WEST | NORTHWEST) "CENTER"> 
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gridx 和 gridy 的 值 受到 了 特殊 处 理 ， 因 为 如 果 手 工 设 定 会 很 兄长 且 易 于 出 错 。 因 此 ， 
提供 它们 的 值 是 一 项 可 选 操作 : 


<!ATTLIST cell gridx CDATA #IMPLIED> 
<!ATTLIST cell gridy CDATA #IMPLIED> 


如 果 没 有 提供 这 些 值 ， 程 序 会 通过 如 下 的 启发 式 方法 来 确定 它们 : 在 第 0 列 ，gridx 的 
默认 值 是 0; 否则 ， 它 是 前 面 的 gridx 加 上 前 面 的 gridwidth; gridy 的 默认 值 总 是 与 行 数 
相同 。 这 样 ， 在 大 多 数 跨 越 多 行 的 情况 下 ， 你 都 不 必 指 定 gridx 和 gridy 的 值 。 但 是 ， 如 
果 一 个 构件 跨越 多 列 ， 那 么 每 当 要 跨 过 这 个 构件 时 ， 


A GridBagtest | 
就 必须 指定 gridx。 =a quick brown fox 
imps over the lazy d 
注意 : 网 格 组 专家 可 能 会 奇怪 ， 我 们 为 什么 不 使 1， foe $ 4 


用 RELATIVE 和 REMAINDER 机 制 让 网 格 组 布局 
自动 确定 gridx 和 gridy 的 位 置 呢 ? 我 们 试 过 
这 种 方法 ， 但 是 怎么 也 不 能 产生 图 3-4 中 那个 字 
体 对 话 框 示 例 的 布局 。 阅 读 了 GridBagLayout 
的 源 代码 后 ， 我 们 发 现 ， 很 明显 ， 它 的 算法 没有 
完成 恢复 绝对 位 置 所 必需 的 繁重 任务 。 


这 个 程序 对 属性 进行 解析 ， 并 且 设置 了 网 格 组 的 


约束 条 件 。 例 如 ， 要 读 取 网 格 宽度 ， 程 序 只 需 包 含 下 = as 
面 这 行 语句 : 图 3-4 由 XML 布局 定义 的 字体 对 话 要 


constraints.gridwidth = Integer.parseInt(e.getAttribute("gridwidth")) ; 


程序 不 必 担 心 属性 的 缺失 ， 因 为 当 文 档 中 没有 指定 任何 其 他 的 值 时 ， 解 析 器 会 自动 提供 
其 默认 值 。 

如 果 要 测试 是 否 指定 了 gridx 或 gridy 属性 ， 我 们 可 以 调用 getAttribute 方法 来 检查 它 
是 否 返回 空 串 : 


String value = e.getAttribute("gridy"); 

if (value.length() == 0) // use default 
constraints.gridy = r; 

else 
constraints.gridy = Integer.parseInt (value) ; 


我 们 发 现 允 许 单元 格 包含 任意 对 象 会 显得 很 方便 ， 这 使 我 们 能 够 指定 如 边界 那样 的 非 构 
件 类 型 。 我 们 只 要 求 这 些 对 象 属于 这 样 的 类 : 它 具 有 一 个 默认 构造 器 ， 而 对 每 个 属性 都 提供 
了 相应 的 获取 器 (getter) /设置 器 (setter) 对 。( 例 如 被 称 为 JavaBean 的 类 。) 

bean 是 由 一 个 类 名 和 0 或 多 个 属性 定义 的 : 


<!ELEMENT bean (class, property*)> 
<!ELEMENT class (#PCDATA)> 


属性 包含 一 个 名 字 和 一 个 值 。 
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<!ELEMENT property (name, value)> 
<!ELEMENT name (#PCDATA) > 


该 值 可 以 是 整数 、 布 尔 值 、 字 符 串 或 者 其 他 bean: 


<!ELEMENT value (int|string|boolean|bean)> 
<!ELEMENT int (#PCDATA)> 

<!ELEMENT string (#PCDATA)> 

<!ELEMENT boolean (#PCDATA)> 


下 面 是 一 个 典型 示例 ， 这 是 一 个 JLabel 对 象 的 实例 ， 它 的 文本 属性 被 设 为 "Face: "。 


<bean> 
<class>javax. swing. JLabel</class> 
<property> 
<name>text</name> 
<value><string>Face: </string></value> 
</property> 
</bean> 


把 字符 串 用 <string> 标签 围 起 来 似乎 有 点 麻烦 。 为 什么 不 只 用 #PCDATA 表示 字符 串 而 
只 留 下 用 于 其 他 类 型 的 标签 呢 ? 因为 那样 我 们 就 需要 使 用 混合 式 内 容 ， 并 且 会 把 value 元 素 
的 规则 弱化 为 : 

<!ELEMENT value (#PCDATA|int|boolean|bean) *> 

这 样 的 规则 允许 由 任意 文本 和 标签 构成 的 混合 内 容 。 

程序 可 以 使 用 BeanInfo 类 来 设置 属性 ， 而 BeanInfo 可 以 枚 举 bean 的 属性 描述 符 。 我 
们 用 匹配 名 字 的 方式 来 查找 属性 ， 然 后 调用 它 的 setter 方法 来 设置 其 值 。 

当 我 们 的 程序 读 人 一 个 用 户 界面 描述 时 ， 它 有 足够 的 信息 来 构建 和 布局 用 户 界 面 构件 。 
但 是 ， 当 然 ， 这 个 界面 是 死 的 ， 因 为 它 没有 事件 监听 器 。 如 果 要 添加 事件 监听 器 ， 我 们 必须 
先 定位 构件 。 因 为 这 个 缘故 ， 我 们 为 每 个 bean 提供 了 ID 类 型 的 可 选 属性 : 

<!ATTLIST bean id ID #IMPLIED> 

例如 ， 下 面 是 一 个 带 有 ID 的 组 合 框 : 


<bean id="face"> 
<class>javax. swing. ]ComboBox</class> 
</bean> 


请 回想 一 下 ， 我 们 说 过 解析 器 会 检查 ID 是 否 唯一 。 
程序 员 可 以 用 下 面 的 方式 来 添加 事件 处 理 器 : 


gridbag = new GridBagPane("fontdialog. xml"); 
setContentPane(gridbag) ; 

JComboBox face = (JComboBox) gridbag.get ("face"); 
face.addListener(listener) ; 


注意 : 在 这 个 示例 中 ， 我 们 只 使 用 了 XML 来 描述 构件 布局 ， 而 把 在 Java 代码 中 添加 事 
件 处 理 器 的 工作 留 给 了 程序 员 。 你 可 以 更 进一步 ， 将 该 代码 添加 到 XML 描述 中 去 。 最 
有 前 途 的 方式 是 用 JavaScript 这 样 的 脚本 语言 来 编码 这 种 代码 。 如 果 你 想 添加 这 样 的 增 
强 功能 ， 请 参考 第 8 章 描 述 的 Nashorn JavaScript 解释 器 。 
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程序 清单 3-2 的 程序 显示 了 如 何 使 用 GridBagPane 类 来 完成 设 定 网 格 组 布局 时 所 有 的 
无 聊 工 作 ， 这 个 布局 是 在 程序 清单 3-4 中 定义 的 。 图 3-4 显示 了 运行 结果 。 该 程序 只 初始 化 
了 组 合 框 (这 项 工作 对 于 GridBagPane 支持 的 bean 属性 设 定 机 制 来 说 过 于 复杂 了 ) 和 添加 
事件 监听 器 ; 程序 清单 3-3 中 的 GridBagPane 类 用 于 解析 XML 文件 ， 构 造 构件 并 放置 它们 ; 
程序 清单 3-5 显示 的 是 DTD 文件 。 

如 果 选 择 了 包含 字符 串 -Schema 的 文件 ， 那 么 该 程序 除了 DTD ， 还 可 以 处 理 Schema. 

程序 清单 3-6 就 包含 了 这 样 的 Schema, 

这 个 例子 是 XML 的 典型 用 法 。 XML 格式 十 分 健壮 ， 足 以 表达 复杂 的 关系 。 在 此 基础 上 ， 
通过 接管 有 效 性 检查 和 提供 默认 值 等 例 行 工 作 ，XML 解析 器 添加 了 新 的 价值 。 








package read; 


import java.awt.*; 
import java.awt.event.*; 
import java.io.*; 

import javax.swing.*; 


/** 

* This program shows how to use an XML file to describe a gridbag layout, 
10 * @version 1.12 2016-04-27 
11 * @author Cay Horstmann 


ono n OO tm A u N e 


2o */ 

13 public class GridBagTest 

14 { 

15 public static void main(String[] args) 

16 { 

17 EventQueue.invokeLater(() -> 

18 

19 JFileChooser chooser = new JFileChooser("."); 
20 chooser. show0penDialog(nul1) ; 

21 File file = chooser.getSelectedFile(); 

22 JFrame frame = new FontFrame(file); 

23 frame. setTitle("GridBagTest") ; 

24 frame. setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE) ; 
25 frame. setVisible(true) ; 

26 H); 

27 } 

28 } 

29 

30 /** 


31 * This frame contains a font selection dialog that is described by an XML file. 

32 * @param filename the file containing the user interface components for the dialog 
n 

34 Class FontFrame extends JFrame 

3 { 

36 private GridBagPane gridbag; 

37 private JComboBox<String> face; 

38 private JComboBox<String> size; 
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39 private JCheckBox bold; 
40 private JCheckBox italic; 


42 @SuppressWarnings ("unchecked") 
43 public FontFrame(File file) 


45 gridbag = new GridBagPane(file) ; 

46 add (gridbag) ; 

47 

48 face = (JComboBox<String>) gridbag.get("face"); 

49 size = (JComboBox<String>) gridbag.get("size") ; 

50 bold = (JCheckBox) gridbag.get("bold"); 

51 italic = (JCheckBox) gridbag.get("italic"); 

52 

53 face. setModel (new DefaultComboBoxModel<String>(new String[] { "Serif", 
54 "SansSerif", "Monospaced", "Dialog", "DialogInput" })); 
55 

56 size. setModel (new DefaultComboBoxModel<String>(new String[] { "8", 
57 "10", "te “5 "18", "24", "36", "Ag" })); 

58 

59 ActionListener listener = event -> setSample(); 

60 

61 face. addActionListener(listener) ; 

62 size.addActionListener(listener) ; 

63 bold.addActionListener(listener) ; 

64 italic. addActionListener(listener) ; 

65 

66 setSample(); 

67 pack(); 

68 } 

69 

70 /** 

71 * This method sets the text sample to the selected font. 

n */ 

73 public void setSample() 

74 { 

75 String fontFace = face.getItemAt (face. getSelectedIndex()) ; 

76 int fontSize = Integer.parseInt(size.getItemAt (size.getSelectedIndex())); 
77 JTextArea sample = (JTextArea) gridbag.get("sample"); 

78 int fontStyle = (bold.isSelected() ? Font.BOLD : 0) 

79 + (italic.isSelected() ? Font. ITALIC : 0); 

80 

81 sample.setFont(new Font(fontFace, fontStyle, fontSize)); 

82 sample. repaint(); 

83 } 

84 } 





1 package read; 

2 

3 import java.awt.*; 

4 import java.beans.*; 
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import java.i10.*; 

import java. lang. reflect. *; 
import javax.swing.*; 
import javax.xm].parsers.*; 
import org.w3c.dom.*; 


/** 
* This panel uses an XML file to describe its components and their grid bag layout positions. 
a 


public class GridBagPane extends JPanel 
private GridBagConstraints constraints; 


/** 
* Constructs a grid bag pane. 
* @param filename the name of the XML file that describes the pane's components and their 
* positions 
*/ 


public GridBagPane(File file) 
{ 


setLayout(new GridBagLayout()) ; 
constraints = new GridBagConstraints() ; 


try 
{ 
DocumentBuilderFactory factory = DocumentBuilderFactory.newInstance() ; 
factory.setValidating(true) ; 


if (file. toString() .contains("-schema")) 
{ 
factory. setNamespaceAware (true) ; 
final String JAXP_SCHEMA_LANGUAGE = 
"http://java.sun.com/xm] /jaxp/properties/schemaLanguage’ ; 
final String W3C_XML_SCHEMA = "http: //www.w3.org/2001/XMLSchema" ; 
factory. setAttribute(JAXP_SCHEMA_LANGUAGE, W3C_XML_SCHEMA) ; 
} 


factory.setIgnoringE]ementContentwhi tespace(true) ; 


DocumentBuilder builder = factory.newDocumentBui lder() ; 
Document doc = builder. parse(file); 
parseGridbag(doc.getDocumentE] ement ()) ; 


catch (Exception e) 


{ 
e.printStackTrace() ; 


} 


[** 

* Gets a component with a given name. 

* @param name a component name 

* @return the component with the given name, or null if no component in this grid bag pane has 
* the given name 
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1 


public Component get(String name) 


{ 


} 


Component [] components = getComponents () ; 
for (int 1 = 0; 1 < components. length; i++) 
{ 


if (components [i] ,getName() ,equals(name)) return components [i]; 


return null; 


/** 


* Parses a gridbag element. 
* @param e a gridbag element 


*/ 


private void parseGridbag(Element e) 


{ 


} 


NodeList rows = e.getChildNodes(); 
for (int i = 0; i < rows.getLength(); i++) 


Element row = (Element) rows.item(i); 
NodeList cells = row.getChildNodes(); 


for (int j = 0; j < cells.getLength(); j++) 


Element cell = (Element) cells.item(j); 
parseCell(cell, i, j); 
} 
} 


/** 


* Parses a cel] element. 


* @param e a cell element 

* @param r the row of the cell 

* @aram c the column of the cell 
gi 


private void parseCell (Element e, int r, int c) 


{ 


// get attributes 


String value = e.getAttribute("gridx"); 
if (value.lengthQ == 0) // use default 
{ 


if (c == 0) constraints.gridx = 0; 
else constraints.gridx += constraints.gridwidth; 


} 


else constraints.gridx = Integer.parseInt(value) ; 

value = e.getAttribute("gridy"); 

if (value.lengthQ) == 0) // use default 
constraints.gridy = r; 

else constraints.gridy = Integer.parseInt (value) ; 


constraints.gridwidth = Integer.parseInt(e.getAttribute("gridwidth")); 
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constraints.gridheight = Integer.parseInt(e.getAttribute("gridheight")); 
constraints.weightx = Integer. parseInt(e.getAttribute(“weightx")) ; 
constraints.weighty = Integer. parseInt(e.getAttribute("weighty")) ; 
constraints.ipadx = Integer.parseInt(e.getAttribute("ipadx")); 
constraints.ipady = Integer. parseInt(e.getAttribute("ipady")) ; 


// use reflection to get integer values of static fields 
Class<GridBagConstraints> cl = GridBagConstraints.class; 


try 
{ 
String name = e.getAttribute("fill"); 
Field f = cl].getField(name) ; 
constraints. fill = f.getInt(cl); 


name = e.getAttribute("anchor’) ; 
f = cl.getField(name) ; 
constraints.anchor = f.getInt(cl); 


catch (Exception ex) // the reflection methods can throw various exceptions 


ex.printStackTrace() ; 


} 


Component comp = (Component) parseBean((Element) e.getFirstChild()); 
add(comp, constraints); 


} 


/** 


* Parses a bean element. 

* @param e a bean element 

E: 

private Object parseBean(Element e) 


{ 
try 
{ 
NodeList children = e.getChildNodes(); 
Element classElement = (Element) children.item(0); 
String className = ((Text) classElement.getFirstChild()).getData() ; 


Class<?> cl = Class. forName(className) ; 
Object obj = cl.newInstance(); 
if (obj instanceof Component) ((Component) obj) .setName(e.getAttribute("id")); 
for (int 1 = 1; i < children.getLength(); i++) 
{ 
Node propertyElement = children.item(i); 
Element nameElement = (Element) propertyElement.getFirstChild(); 
String propertyName = ((Text) nameElement.getFirstChild().getDataQ; 


Element valueElement = (Element) propertyElement.getLastChild(); 
Object value = parseValue(valueE]ement) ; 
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167 BeanInfo beanInfo = Introspector.getBeanInfo(cl) ; 

168 PropertyDescriptor[] descriptors = beanInfo.getPropertyDescriptors() ; 
169 boolean done = false; 

170 for (int j = 0; !done & j < descriptors. length; j++) 

171 

172 if (descriptors [j].getName() .equals(propertyName) ) 

173 { 

174 descriptors [j].getWriteMethod().invoke(obj, value); 
175 done = true; 

176 } 

177 } 

178 } 

179 return obj; 

180 

181 catch (Exception ex) // the reflection methods can throw various exceptions 
182 { 

183 ex.printStackTrace() ; 

184 return null; 

185 } 

186 } 

187 

188  /** 


189 * Parses a value element. 

190 * @param e a value element 

191 */ 

192 private Object parseValue(Element e) 


194 Element child = (Element) e.getFirstChild(); 

195 if (child. getTagName().equals("bean")) return parseBean(child) ; 

196 String text = ((Text) child.getFirstChild()) .getData() ; 

197 if (child.getTagName() .equals("int")) return new Integer(text) ; 

198 else if (child.getTagName() .equals("boolean")) return new Boolean(text) ; 
199 else if (child.getTagName() .equals("string")) return text; 

200 else return null; 

201 } 

202 } 









1 <?xml version="1.0"?> 
2 <!DOCTYPE gridbag SYSTEM "gridbag.dtd"> 
3 <gridbag> 


4 <row> 

5 <cell anchor="EAST"> 

6 <bean> 

7 <class>javax. swing. JLabel</class> 

8 <property> 

9 <name>text</name> 

10 <value><string>Face: </string></value> 
11 </property> 

12 </bean> 

13 </cell> 


14 <cel] fill="HORIZONTAL" weightx="100"> 





<bean id="face"> 
<Class>javax. swing. JComboBox</class> 
</bean> 
</cell> 


<cell gridheight="4" fill="BOTH" weightx="100" weighty="100"> 


<bean id="Sample"> 
<class>javax. swing. JTextArea</class> 
<property> 
<name>text</name> 
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<value><string>The quick brown fox jumps over the lazy dog</string></value> 


</property> 
<property> 
<name>edi tab] e</name> 


<value><bool ean>fal se</bool ean></value> 


</property> 
<property> 
<name>rows</name> 
<value><int>8</int></value> 
</property> 
<property> 
<name>columns</name> 
<value><int>20</int></value> 
</property> 
<property> 
<name>] ineWrap</name> 
<value><boolean>true</bool ean></value> 
</property> 
<property> 
<name>border</name> 
<value> 
<bean> 


<class>javax. swing. border. EtchedBorder</class> 


</bean> 
</value> 
</property> 
</bean> 
</cell> 
</row> 
<row> 
<cell anchor="EAST"> 
<bean> 
<class>javax. swing. JLabel</class> 
<property> 
<name>text</name> 
<value><string>Size: </string></value> 
</property> 
</bean> 
</cell> 
<cell fill="HORIZONTAL” weightx="100"> 
<bean id="size"> 
<class>javax. swing. JComboBox</class> 
</bean> 
</cell> 
</row> 
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69 <row> 


70 <cell gridwidth="2" weighty="100"> 

71 <bean id="bold"> 

72 <class>javax. swing. JCheckBox</class> 
73 <property> 

74 <name>text</name> 

75 <value><string>Bold</string></value> 
76 </property> 

77 </bean> 

78 </cell> 

79 </row> 

80 <row> 

81 <cel] gridwidth="2" weighty="100"> 

82 <bean id="italic"> 

83 <class>javax. swing. JCheckBox</class> 
84 <property> 

85 <name>text</name> 

86 <value><string>Italic</string></value> 
87 </property> 

88 </bean> 

89 </cell> 

90 </ row> 


91 </gridbag> 





1 <!ELEMENT gridbag (row)*> 

2 <!ELEMENT row (cell)*> 

3 <!ELEMENT cell (bean)> 

4 <!ATTLIST cell gridx CDATA #IMPLIED> 

5 <!ATTLIST cell gridy CDATA #IMPLIED> 

6 <!ATTLIST cell gridwidth CDATA "1"> 

7 <!ATTLIST cel] gridheight CDATA "1"> 

8 <!ATTLIST cell weightx CDATA "0"> 

9 <!ATTLIST cell weighty CDATA "0"> 

10 <!ATTLIST cell fill (NONE|BOTH|HORIZONTAL|VERTICAL) “NONE > 
11 <!ATTLIST cell anchor 

12 (CENTER| NORTH | NORTHEAST | EAST | SOUTHEAST | SOUTH | SOUTHWEST |WEST|NORTHWEST) “CENTER > 
13 <!ATTLIST cell ipadx CDATA "0"> 

14 <!ATTLIST cell ipady CDATA "0"> 


16 <!ELEMENT bean (class, property*)> 
17 <!ATTLIST bean id ID #IMPLIED> 


19 <!ELEMENT class (#PCDATA)> 

20 <!ELEMENT property (name, value)> 

21 <!ELEMENT name (#PCDATA) > 

22 <!ELEMENT value (int|string|boolean|bean)> 
23 <!ELEMENT int (#PCDATA)> 

24 <!ELEMENT string (#PCDATA)> 

25 <!ELEMENT boolean (#PCDATA)> 





1 
2 
3 
4 
5 
6 
7 
8 
9 


10 
11 
12 
13 
14 
15 
16 





<xsd:schema xmlns:xsd="http: //www.w3.org/2001/XMLSchema"> 


<xsd:element name="gridbag" type="GridBagType"/> 


<xsd:element name="bean" type="BeanType'/> 


<xsd:complexType name="GridBagType''> 


<xsd: Sequence> 


<xsd:element name="row" type="Rowlype” minOccurs="0" maxOccurs="unbounded"/> 


</xsd: Sequence> 
</xsd:comp]exType> 


<xsd:complexType name="RowType"> 


<xsd: Sequence> 


<xsd:element name="cell" type="CellType" minOccurs="0" maxOccurs="unbounded"/> 


</xsd: sequence> 
</xsd: comp] exType> 


<xsd:complexType name="CellType"> 


<XSd Sequence> 


<xsd:element ref="bean /> 


</xsd: Sequence> 


<xsd:attribute name="gridx" type="xsd:int" use="optional"/> 

<xsd:attribute name="gridy" type="xsd:int" use="optional"/> 

<xsd:attribute name="gridwidth" type="xsd:int" use="optional" default="1" /> 
<xsdiattribute name="gridheight" type="xsd:int" use="optional" default="1" /> 
<xsd:attribute name="weightx" type="xsd:int" use="optional" default="0" /> 
<xsd:attribute name="weighty" type="xsd:int" use="optional" default="0" /> 
<xsd:attribute name="fill" use="optional" defaul t="NONE"> 


<xsd:simplelype> 


<xsd: restriction base="xsd:string'> 


<xsd:enumeration 
<xsd:enumeration 
<xsd:enumeration 
<xsd:enumeration 
</xsd:restriction> 
</xsd:simpleType> 
</xsd:attribute> 


<xsd:attribute name="anchor" use="optional" default="CENTER"> 


<xsd:simpleType> 


value="NONE" /> 
value="BOTH" /> 
value="HORIZONTAL" /> 
value="VERTICAL" /> 


<xsd:restriction base="xsd:string'> 


<xsd:enumeration 
<xsd:enumeration 
<xsd:enumeration 
<xsd:enumeration 
<xsd:enumeration 
<xsd:enumeration 
<xsd:enumeration 
<xsd:enumeration 
<xsd:enumeration 
</xsd:restriction> 
</xsd:simpleType> 


value="CENTER" /> 
value="NORTH" /> 
value="NORTHEAST” /> 
value="EAST" /> 
value="SOUTHEAST” /> 
value="SOUTH" /> 
value="SOUTHWEST" /> 
value="WEST” /> 
value="NORTHWEST” /> 
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53 </xsd:attribute> 
54 <xsd:attribute name="ipady" type="xsd:int" use="optional” default="0" /> 
55 <xsd:attribute name="ipadx" type="xsd:int" use="optional" default="0" /> 


56 </xsd:complexType> 


58 <xsd:complexType name="BeanType"> 


59 <xsd:sequence> 

60 <xsd:element name="class" type="xsd:string"/> 

61 <xsd:element name="property" type="PropertyType” minOccurs="0" maxOccurs="unbounded"/> 
62 </xsd: Sequence> 

63 <xsd:attribute name="id" type="xsd:ID" use="optional" /> 


64 </xsd:comp]exType> 


66  <xsd:complexType name="PropertyType"> 


67 <xSd: sequence> 
68 <xsd:element name="name" type="xsd:string"/> 
69 <xsd:element name="value" type="ValueType"/> 
70 </xsd: Sequence> 


71 </xsd:complexType> 


733 <xsd:complexType name="ValueType"> 


74 <xsd:choice> 

75 <xsd:element ref="bean"/> 

76 <xsd:element name="int" type="xsd:int"/> 

77 <xsd:element name= String” type="xsd:string'/> 
78 <xsd:element name="boolean" type="xsd:boolean"/> 
79 </xsd:choice> 


80 </xsd:complexType> 
81 </xsd:schema> 


3.4 (ĦA XPath 来 定位 信息 


如 采 要 定位 茶 个 XML 文档 中 的 一 段 特定 信息 ， 那 么 ， 通 过 遍历 DOM 树 的 众多 节点 来 
PETA RS isa LER. XPath 语言 使 得 访问 树 节 点 变 得 很 容易 。 例 如 ,假设 有 如 下 XML 
文档 : 

<configuration> 

<database> 
<username>dbuser</username> 


<password>secret</password> 


</database> 
</confi guration> 


可 以 通过 对 XPath 表达 式 /conf i guration/database/username 求 值 来 得 到 database 
中 的 username 的 值 。 

使 用 Xpath 执行 下 列 操作 比 普 通 的 DOM 方式 要 简单 得 多 : 

1 )" 获 得 文档 节点 。 
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2) 枚 举 它 的 子 元 素 。 

3) 定位 database 元 素 。 

4) 定位 其 子 节点 中 名 字 为 username 的 节点 。 
5) 定位 其 子 节点 中 的 text 市 点 。 


6 ) 获取 其 数据 。 
XPath 可 以 描述 XML 文档 中 的 一 个 节点 集 ， 例如， 下 面 的 XPath: 
/gridbag/row 


描述 了 根 元 素 gridbag 的 子 元 素 中 所 有 的 row 元素。 可 以 用 [] 操作 符 来 选择 特定 元 素 : 
/gridbag/row(1] 
这 表示 的 是 第 一 行 (索引 号 从 1 开始 )。 
使 用 @ 操 作 符 可 以 得 到 属性 值 。XPath 表达 式 
/gridbag/row[1] /ce11 [1] /@anchor 
描述 了 第 一 行 第 一 个 单元 格 的 anchor 属性 。XPath 表达 式 
/gridbag/row/cell/@anchor 
描述 了 作为 根 元 素 gridbag 的 子 元 素 的 那些 row 元 素 中 的 所 有 单元 格 的 anchor JRT A o 
XPath 有 很 多 有 用 的 函数 ， 例 如 : 
count (/gridbag/row) 
返回 gridbag 根 元 素 的 row 子 元 素 的 数量 。 精 细 的 XPath 表达 式 还 有 很 多 ， 请 参见 http:// 
www.w3c.org/TR/xpath 的 规范 ， 或 者 在 http://www.zvon.org/xxl/XPathTutorial/ General/examples. 
html 上 的 一 个 非常 好 的 在 线 指南 。 
Java SE 5.0 增加 了 一 个 API 来 计算 XPath 表达 式 ， 首 先 需要 从 XPathFactory 创建 一 个 
XPath 对 象 : 


XPathFactory xpfactory = XPathFactory.newInstance() ; 
path = xpfactory.newXPath() ; 


然后 ， 调 用 evaluate 方法 来 计算 XPath 表达 式 : 

String username = path.evaluate("/configuration/database/username", doc) ; 

你 可 以 用 同一 个 XPath 对 象 来 计算 多 个 表达 式 。 

这 种 形式 的 evaluate 方法 将 返回 一 个 字符 串 。 这 很 适合 用 来 获取 文本 ， 比 如 前 面 的 例 
子 中 的 username 节点 中 的 文本 。 如 果 XPath 表达 式 产生 了 一 组 节点 ， 请 做 如 下 调用 : 


NodeList nodes = (NodeList) path.evaluate("/gridbag/row", doc, XPathConstants.NODESET) ; 
如 果 结 果 只 有 一 个 节点 ， 则 以 XPathConstants .NODE 代替: 

Node node = (Node) path.evaluate("/gridbag/row[1]", doc, XPathConstants.NODE) ; 

如 果 结 果 是 一 个 数字 ， 则 使 用 XPathConstants .NUMBER: 
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int count = 


不 必 从 文档 的 根 节 点 开始 搜索 ， 可 以 从 任意 一 
个 节点 或 节点 列表 开始 。 人 例如， 如果 你 有 前 一 次 计 
算得 到 的 节点 ， 那 么 就 可 以 调用 : 


result = path.evaluate(expression, node); 


序 清单 3-7 中 的 程序 演示 了 XPath 表达 式 的 


求 值 操作 。 只 要 载 人 一 个 XML 文件 ， 键 人 一 个 表 
达 式 ， 选 择 表 达 式 的 类 型 ， 点 击 计算 按钮 ， 表 达 式 


的 结果 就 会 在 框架 底部 显示 出 来 了 ( 见 图 3-5 ) 。 


((Number) path.evaluate("count(/gridbag/row)", doc, XPathConstants.NUMBER)).intValue(): 


s XPathTes 


<?xmwl versions” 1.0"?> 
<!DOCTYPE gridbag SYSTEM "gridbag. dtd” > 


<cell anchor="EAST"> 
<bean> 
<class > javax. swing. JLabel</class>| 
<property> 
<name >text< /name> 





图 3-5 计算 XPath 表达 式 





package xpath; 


import java.awt.*: 

import java.awt.event.*: 
import java.io.*: 

import java.nio.file.*; 
import java.util.*: 

import javax.swing.*; 

import javax.swing.border.*: 
import javax.xm].namespace.*; 
import javax.xm].parsers.*; 
12 import javax.xml .xpath.*; 

13 import org.w3c.dom.*: 

14 Import org.xml.sax.*; 


Lw oOo “4 ODO Aa A č u N j 


Ia p 
he © 


16 /** 

17 * This program evaluates XPath expressions. 
18 * @version 1.02 2016-05-10 

19 * @author Cay Horstmann 


20 */ 

21 public class XPathTester 

2 { 

23 public static void main(String[] args) 

24 { 

25 EventQueue.invokeLater(() -> 

26 { 

27 JFrame frame = new XPathFrame()， 
28 frame.setTitle("XPathTest"); 

29 frame. setDefaultCloseOperation(JFrame.EXIT_ON CLOSE); 
30 frame. setVisible(true) ; 

31 H; 

32 } 

3 } 

34 

35 /** 


36 * This frame shows an XML document, a panel to type an XPath expression, and a text field to 


37 * display the result. 


38 
39 
40 


gi 


class XPathFrame extends JFrame 


{ 


private DocumentBuilder builder; 
private Document doc; 

private XPath path; 

private JTextField expression; 
private JTextField result; 

private JTextArea docText; 

private JComboBox<String> typeCombo; 


public XPathFrame() 


{ 


JMenu fileMenu = new JMenu("File'); 

JMenultem openItem = new JMenuItem("Open") ; 
openItem.addActionListener(event -> openFile()); 
fi leMenu.add(openItem) ; 


JMenuItem exitItem = new JMenuItem("Exit"); 
exitItem.addActionListener(event -> System.exit(0)); 
fileMenu.add(exitItem) ; 


JMenuBar menuBar = new JMenuBar(); 
menuBar.add(fi]eMenu) ; 
setJMenuBar(menuBar) ; 


ActionListener listener = event -> evaluate(); 
expression = new JTextField(20); 

expression. addActionListener(listener) ; 

JButton evaluateButton = new JButton("Evaluate"); 
evaluateButton. addActionListener(listener) ; 


typeCombo = new JComboBox<String>(new String[] { 
"STRING", "NODE", "NODESET", "NUMBER", "BOOLEAN" }); 
typeCombo. setSelectedItem("STRING") ; 


JPanel panel = new JPanel (); 

panel .add(expression) ; 

panel .add(typeCombo) ; 

panel .add(evaluateButton) ; 

docText = new JTextArea(10, 40); 

result = new JTextField(); 
result.setBorder(new TitledBorder("Result")) ; 


add(panel, BorderLayout.NORTH) ; 
add(new JScrol]Pane(docText), BorderLayout.CENTER) ; 
add(result, BorderLayout. SOUTH) ; 


try 
{ 


DocumentBuilderFactory factory = DocumentBuilderFactory.newInstance() ; 
builder = factory.newDocumentBui lder() ; 


catch (ParserConfigurationException e) 
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92 { 

93 JOptionPane.showMessageDialog(this, e); 

94 } 

95 

96 XPathFactory xpfactory = XPathFactory.newInstance() ; 
97 path = xpfactory.newXPath() ; 

98 pack(); 

99 } 

100 

11  /** 

102 * Open a file and load the document. 

103 */ 

104 public void openFile() 

105 { 

106 JFileChooser chooser = new JFileChooser(); 

107 chooser. setCurrentDi rectory(new File("xpath")); 
108 

109 chooser. setFi leFilter( 

110 new javax.swing.filechooser.FileNameExtensionFilter("XML files", "xml")); 
111 int r = chooser. show0penDialog(this) ; 

112 if (r != JFileChooser.APPROVE_OPTION) return: 
113 File file = chooser.getSelectedFile(); 

114 try 

115 

116 docText.setText (new String(Files.readAl ]Bytes(file.toPath()))); 
117 doc = builder. parse(file); 

118 } 

119 catch (IOException e) 

120 

121 JOptionPane.showMessageDialog(this, e); 

122 } 

123 catch (SAXException e) 

124 

125 JOptionPane.showMessageDialog(this, e); 

126 } 

127 } 


129 public void evaluate() 


30 {d 

131 try 

132 { 

133 String typeName = (String) typeCombo.getSelectedItem() ; 

134 QName returnType = (QName) XPathConstants.class.getField(typeName) .get (null); 
135 Object evalResult = path.evaluate(expression.getText(), doc, returnType) ; 
136 if (typeName. equals ("NODESET")) 

137 { 

138 NodeList list = (NodeList) evalResult; 

139 // Can't use String.join since NodeList isn't Iterable 

140 StringJoiner joiner = new StringJoiner(",", "{", "}"); 

141 for (int i = 0; i < list.getLength(); i++) 

142 joiner.add("" + list.item(i)); 

143 result.setText("" + joiner); 

144 } 

145 else result.setText("" + evalResult); 
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147 catch (XPathExpressionException e) 

148 

149 result.setText("" + e); 

150 

151 catch (Exception e) // reflection exception 
152 

153 e.printStackTrace() ; 





e static XPathFactory newInstance() 
返回 用 于 创建 XPath 对 象 的 XPathFactory 实例 。 

e XPath newXpath( ) 

构建 用 于 计算 XPath 表达 式 的 XPath 对 象 。 





e String evaluate(String expression, Object startingPoint) 
从 给 定 的 起 点 计算 表达 式 。 起 点 可 以 是 一 个 节点 或 节点 列表 。 如 果 结 果 是 一 个 节点 或 
节点 集 ， 则 返回 的 字符 串 由 所 有 文本 节点 子 元 素 的 数据 构成 。 

e Object evaluate(String expression, Object startingPoint, QName 
resultType) 

从 给 定 的 起 点 计算 表达 式 。 起 点 可 以 是 一 个 节点 或 节点 列表 。resultType 是 
XPathCconstants 类 的 常量 STRING、NODE、NODESET、NUMBER z% BOOLEAN 之 一 。 
返回 值 是 String、Node、NodeList、 Number 或 Boolean, 


3.5 “使 用 命名 空间 


Java 语言 使 用 包 来 避免 名 字 冲 突 。 程 序 员 可 以 为 不 同 的 类 使 用 相同 的 名 字 ， 只 要 它们 不 在 
同一 个 包 中 即 可 。XML 也 有 类 似 的 命名 空间 (namespace) 机 制 ， 可 以 用 于 元 素 名 和 属性 名 。 
名 字 空 间 是 由 统一 资源 标识 符 (Uniform Resource Identifier, URI) 来 标识 的 ， 比 如 : 


http: //www.w3.org/2001/XMLSchema 
uuid: 1¢759aed-b748-475c-ab68-10679700c4f2 
urn:com:books-r-us 


HTTP 的 URL 格式 是 最 常见 的 标识 符 。 注 意 ，URL 只 用 作 标 识 符 字 符 串 ， 而 不 是 一 个 
文件 的 定位 符 。 例 如 ， 名 字 空 间 标识 符 : 


http://www. horstmann.com/corejava 
http://www. horstmann.com/corejava/index. html 
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表示 了 不 同 的 命名 空间 ， 尽 管 Web 服务 器 将 为 这 两 个 URL 提供 同一 个 文档 。 

在 命名 空间 的 URL 所 表示 的 位 置 上 不 需要 有 任何 文档 ，XML 解析 器 不 会 尝试 去 该 处 查 
找 任何 东西 。 然 而 ， 为 了 给 可 能 会 遇 到 不 熟悉 的 命名 空间 的 程序 员 提供 一 些 帮 助 ， 人 们 习惯 
于 将 解释 该 命名 空间 的 文档 放 在 URL 位 置 上 。 例 如 ， 如 果 你 把 浏览 器 指向 XML Schema 的 
命名 空间 URL (http:/www.w3.org /2001/XMLSchema)， 就 会 发 现 一 个 描述 XML Schema 标 
准 的 文档 。 

为 什么 要 用 HTTP URL 作为 命名 空间 的 标识 符 ? 这 是 因为 这 样 容 易 确保 它们 是 独一无二 
的 。 如 果 使 用 实际 的 URL， 那 么 主机 部 分 的 唯一 性 就 将 由 域名 系统 来 保证 。 然 后 ， 你 的 组 织 
可 以 安排 URL 余下 部 分 的 唯一 性 ， 这 和 Java 包 名 中 的 反 向 域名 是 一 个 原理 。 

尽管 长 名 字 空 间 的 唯一 性 很 好 ,但 是 你 肯定 不 想 处 理 超出 必需 范围 的 长 标识 符 。 在 Java 
编程 语言 中 ， 可 以 用 import 机 制 来 指定 很 长 的 包 名 ， 然 后 就 可 以 只 使 用 较 短 的 类 名 了 。 在 
XML 中 有 类 似 的 机 制 ， 比 如 : 


<element xm|ns="namespaceURI"> 
children 
</element> 


现在 ， 该 元 素 和 它 的 子 元 素 都 是 给 定 命名 空间 的 一 部 分 了 。 
子 元 素 可 以 提供 自己 的 命名 空间 ， 例 如 : 


<element xm|ns="namespaceURI1"> 
<child xmlns="namespaceURI2"> 
grandchildren 
</child> 
more children 
</element> 


这 时 ， 第 一 个 子 元 素 和 和 孙 元 素 都 是 第 二 个 命名 空间 的 一 部 分 。 

无 论 是 只 需要 一 个 命名 空间 ， 还 是 命名 空间 本 质 上 是 散 套 的 ， 这 个 简单 机 制 都 工作 得 很 
好 。 如 硅 不 然 ， 就 需要 使 用 第 二 种 机 制 ， 而 Java 中 并 没有 类 似 的 机 制 。 你 可 以 用 一 个 前 缀 来 
表示 命名 空间 ， 即 为 特定 文档 选取 的 一 个 短 的 标识 符 。 下 面 是 一 个 典型 的 例子 : 

<xsd:schema xmlns:xsd="http://www.w3.0rg/2001/XMLSchema"> 

<xsd:element name="gridbag" type="GridBagType"/> 

</xsd:schena> 

下 面 的 属性 : 

xmlns: prefix="namespaceURI" 
用 于 定义 命名 空间 和 前 级 。 在 我 们 的 例子 中 ， 前 缀 是 字符 串 xsd。 这 样 ，xsd:schema 实际 
上 指 的 是 命名 空间 http://www.w3.org/2001/XMLSchema 中 的 schema. 
注意 : 只 有 子 元 素 继承 了 它们 父 元 素 的 命名 空间 ， 而 不 带 显 式 前 组 的 属性 并 不 是 命名 空 

间 的 一 部 分 。 请 看 下 面 这 个 特意 构造 出 来 的 例子 : 


<configuration xmlns="http://www.horstmann.com/corejava" 
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xmlns:si="http://www. bipm. fr/enus/3_SI/si. html > 


<size value="210" si:unit="mm"/> 
</configurati on> 
在 这 个 示例 中 , AH configuration fe size 是 URI 为 http://www.horstmann.com/ 
corejava 的 命名 空间 的 一 部 分 。 属 性 si:unit 是 URI A http://www.bipm.fr/enus/3_SI/si.html 
的 命名 空间 的 一 部 分 。 然 而 ， 属 性 value 不 是 任何 命名 空间 的 一 部 分 。 


你 可 以 控制 解析 器 对 命名 空间 的 处 理 。 默 认 情 况 下 ，Java XML 库 的 DOM fe Bt ae FF AE 
“命名 空间 感知 的 ”。 

要 打开 命名 空间 人 处理 特性 ， 请 调用 DocumentBuilderFactory 类 的 setNamespace 
Aware 方法 ， 

factory,SetNamespaCeAware(true) ; 

这 样 ， 该 工厂 产生 的 所 有 生成 器 便 都 支持 命名 空间 了 。 每 个 节点 有 三 个 属性 : 

o 带 有 前 级 的 限定 名 (qualified)， 由 getNodeName 和 getTagName 等 方法 返回 。 

e 命名 空间 URI, FH getNamespaceURI 方法 返回 。 

e 不 带 前 级 和 命名 空间 的 本 地 名 (local name), H getLocalName 方法 返回 。 

下 面 是 一 个 例子 。 假 设 解析 器 看 到 了 以 下 元 素 : 

<xsd:schema xmlns:xsd="http: //www.w3.org/2001/XMLSchema" > 

它 会 报告 如 下 信息 : 

e INEZ = xsd:schema 

e 命名 空间 URI = http: //www.w3.org/2001/XMLSchema 

e 本 地 名 = schema 


注意 : 如果 对 命名 空间 的 感知 特性 被 关闭 ，getLocalName 和 getNamespaceURI 方法 
将 返回 null, 





e String getLocalName( ) 
AHA CAPA), BATTERED aa NRA A E TEIN, RE nu11。 
e String getNamespaceURI( ) 
返回 命名 空间 URI， 或 者 在 解析 器 不 感知 命名 空间 时 ， 返 回 nu11。 








e boolean isNamespaceAware( ) 


e void setNamespaceAware(boolean value) 
获取 或 设置 工厂 的 namespaceAware 属性 。 当 设 为 true 时 ， DL) PÆ KREI ATEM 
名 空间 感知 的 。 





162 Java SRK Al ZRH 


3.6 ” 流 机 制 解析 器 


DOM 解析 融会 完整 地 恋人 XML 文档 ， 然 后 将 其 转换 成 一 个 树 形 的 数据 结构 。 对 于 大 多 
数 应 用 ，DOM 都 运行 得 很 好 。 但 是 ， 如 果 文 档 很 大 ， 并 且 处 理 算法 又 非常 简单 ， 可 以 在 运 
行 时 解析 节点 ， 而 不 必 看 到 完整 的 树 形 结构 ， 那 么 DOM 可 能 就 会 显得 效率 低下 了 。 在 这 种 
情况 下 ， 我 们 应 该 使 用 流 机 制 解析 器 (streaming parser). 

在 下 面 的 小 节 中 ， 我 们 将 讨论 Java 类 库 提供 的 流 机 制 解析 禹 : 老 而 弥 坚 的 SAX 解析 
器 和 添加 到 Java SE 6 中 的 更 现代 化 的 StAX 解析 器 。SAX 解析 屁 使 用 的 是 事件 回调 ( event 
callback), mi StAX 解析 器 提供 了 遍历 解析 事件 的 迭代 器， 后 者 用 起 来 通常 更 方便 一 些 。 


3.6.1 使 用 SAX 解析 器 


SAX 解析 器 在 解析 XML 输入 数据 的 各 个 组 成 部 分 时 会 报告 事件 ,但 不 会 以 任何 方式 存 
储 文档 ， 而 是 由 事件 处 理 需 建立 相应 的 数据 结构 。 实 际 上 ，DOM 解析 需 是 在 SAX HDT A AY 
基础 上 构建 的 ， 它 在 接收 到 解析 器 事件 时 构建 DOM 树 。 

在 使 用 SAX 解 析 器 时 ， 需 要 一 个 处 理 器 来 为 各 种 解析 器 事件 定义 事件 动作 。 
ContentHandler 接口 定义 了 乔 干 个 在 解析 文档 时 解析 天 会 调用 的 回调 方法 。 下 面 是 最 重要 
的 几 个 : 

e startElement All endElement 在 每 当 遇 到 起 始 或 终止 标签 时 调用 。 

e characters 在 每 当 遇 到 字符 数据 时 调用 。 

e startDocument 和 endDocument 分 别 在 文档 开始 和 结束 时 各 调用 一 次 。 

例如 ， 在 解析 以 下 片段 时 : 


<font> 
<name>Hel vetica</name> 
<size units="pt">36</size> 
</font> 


解析 器 会 产生 以 下 回调 : 

1) startElement, TÆ.: font 

2) startElement, JGZ.: name 

3) characters， 内 容 : Helvetica 

4) endElement, JGZ.: name 

5) startElement, 元 素 名 :， size, JRE: units="pt" 

6) characters, N: 36 

7) endElement, Æ.: size 

8) endElement, ŽA.: font 

处 理 器 必须 覆盖 这 些 方法 ， 让 它们 执行 在 解析 文件 时 我 们 想 要 让 它们 执行 的 动作 。 本 节 
最 后 的 程序 会 打印 出 一 个 HTML 文件 中 的 所 有 链接 <a href="...">。 它 直接 覆盖 了 处 理 
arly) startElement 方法 ， 以 检查 名 字 为 a， 且 属性 名 为 href 的 链接 ， 其 潜在 用 途 包 括 用 
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FA WAER”, M-AR EE TA OR IEN o 
注意 : 遗憾 的 是 ，HTML 不 必 是 合法 的 XML， 大 多 数 HTML 页 面 都 与 良 构 的 XML Z 


别 很 大 ， 以 至 于 示例 程序 无 法 解析 它们 。 但 是 ，W3C 编写 的 大 部 分 页 面 都 是 用 XHTML 
编写 的 ，XHTML 是 一 种 HTML 方言 ， 且 是 良 构 的 XML， 你 可 以 用 这 些 页面 来 测试 示 
例 程序 。 例 如 ， 运 行 : 

java SAXTest http://www.w3c.org/MarkUp 

将 看 到 那个 页 面 上 所 有 链接 的 URL 列表 。 


示例 程序 是 一 个 很 好 的 使 用 SAX 的 例子 。 我 们 根本 不 在 乎 a 元 素 出 现 的 上 下 文 环境 ， 


而 且 不 必 和 存储 树 形 结构 。 


下 面 是 如 何 得 到 SAX 解析 器 的 代码 : 


SAXParserFactory factory = SAXParserFactory.newInstance() ; 
SAXParser parser = factory.newSAXParser() ; 


现在 可 以 处 理 文档 了 : 
parser.parse(source, handler) ; 


这 里 的 source 可 以 是 一 个 文件 、 一 个 URL 字符 串 或 者 是 一 个 输入 流 。handler 属于 


DefaultHandler 的 一 个 子 类 ，Defau1tHand1ler 类 为 以 下 四 个 接口 定义 了 空 的 方法 : 


ContentHandler 
DTDHandler 
EntityResolver 
ErrorHandler 


示例 程序 定义 了 一 个 处 理 器 ， 它 覆盖 了 ContentHandler 接口 的 startElement 方法 ， 


以 观察 带 有 href 属性 的 a TUR} 


DefaultHandler handler = new 
DefaultHandler() 
{ 
public void startElement(String namespaceURI, String Iname, String qname, Attributes attrs) 
throws SAXException 


if (Iname.equalsIgnoreCase("a") && attrs != null) 


{ 
for (int i = 0; i < attrs.getLength(); i++) 


String aname = attrs.getLocalName(1) ; 
if (aname. equal sIgnoreCase("href")) 
System. out.printIn(attrs.getValue(i)); 


} 
} 
f 


startElement 方法 有 3 个 描述 元 素 名 的 参数 ， 其 中 qname 参数 以 prefix:1ocalname 


的 形式 报告 限定 名 。 如 果 命 名 空间 处 理 特 性 已 经 打开 ， 那么 namespaceURI 和 Iname 参数 
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提供 的 就 是 命名 空间 和 本 地 GERE) 名 。 
与 DOM 解 析 器 一 样 ， 命 名 空间 处 理 特性 默认 是 关闭 的 ， 可 以 调用 工厂 类 的 
setNamespaceAware 方法 来 激活 命名 空间 处 理 特 性 : 


SAXParserFactory factory = SAXParserFactory.newInstance() ; 
factory. setNamespaceAware(true) ; 
SAXParser saxParser = factory.newSAXParser() ; 


在 这 个 程序 中 ， 我 们 还 处 理 了 为 一 个 常见 的 问题 。XHTML 文件 总 是 以 一 个 包含 对 DTD 
引用 的 标签 开头 ,解析 融会 加 载 这 个 DTD。 可 以 理解 的 是 ，W3C 肯定 不 乐意 对 诸如 www. 
w3.org/TR/xhtml/DTD/xhtml-strict.dtd 这 样 的 文件 提供 千 万 亿 次 的 下 载 。 总 有 一 天 他 们 会 完全 
拒绝 提供 这 些 文件 ， 但 到 写本 章 时 为 止 ， 他 们 还 在 并 不 情愿 地 提供 DTD 下 载 。 如 果 你 不 需 
要 验证 文件 ， 只 需 调用 : 

factory. setFeature("http://apache.org/xml/features/nonvalidating/load-external-dtd", false); 

程序 清单 3-8 AE SMAI. EREET, KRAN] SAX 的 另 一 个 
有 趣 用 法 ， 即 将 非 XML 数据 源 转换 成 XML 的 一 种 简单 方式 是 报告 XML 解析 器 将 要 报告 的 
SAX 事件 。 详 情 请 参见 3.8 市 。 





package sax; 


1 
2 
3 import java.io.*; 

4 import java.net.*; 

5 import javax.xml.parsers.*; 

6 import org.xml.sax.*; 

7 import org.xml.sax.helpers.*; 
8 

9 


/** 
10 * This program demonstrates how to use a SAX parser. The program prints all hyperlinks of an 
11 * XHTML web page. <br> 
12 * Usage: java sax.SAXTest URL 
13 * @version 1.00 2001-09-29 
14 * @author Cay Horstmann 


15 */ 

16 public class SAXTest 

17 { 

18 public static void main(String[] args) throws Exception 
19 { 

20 String url; 

21 if (args. length == 0) 

22 { 

23 url = "http://www.w3c.org"; 

24 System.out.printIn("Using " + url); 

25 

26 else url = args(0]; 

27 

28 DefaultHandler handler = new DefaultHandler() 


29 { 
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30 public void startElement(String namespaceURI, String Iname, String qname, 
31 Attributes attrs) 

32 { 

33 if (Iname.equals("a") && attrs != null) 

34 

35 for (int 1 = 0; 1 < attrs.getLengthQ); i++) 

36 { 

37 String aname = attrs.getLocalName(i) ; 

38 if (aname.equals("href")) System.out.print]n(attrs.getValue(i)); 
39 } 

40 } 

41 } 

42 H 

43 

44 SAXParserFactory factory = SAXParserFactory.newlnstance() ; 

45 factory. setNamespaceAware(true) ; 

46 factory.setFeature("http://apache.org/xml /features/nonvalidating/load-external-dtd", false); 
47 SAXParser saxParser = factory.newSAXParser() ; 

48 InputStream in = new URL(url) .openStream() ; 

49 SaxParser.parse(in, handler); 

50 } 

q } 


e static SAXParserFactory newInstance() 
返回 SAXParserFactory 类 的 一 个 实例 。 

e SAXParser newSAXParser() 
返回 SAXParser 类 的 一 个 实例 。 

e boolean isNamespaceAware( ) 

e void setNamespaceAware(boolean value) 
获取 和 设置 工厂 的 namespaceAware 属性 。 当 设 为 true ft, HL AMAR iT Are 
命名 空间 感知 的 。 

e boolean isValidating( ) 

evoid setValidating(boolean value) 
获取 和 设置 工矿 的 validating 属性 。 当 设 为 true 时 ,该 工厂 生成 的 解析 副将 要 验证 
其 输入 。 





evoid parse(File f, DefaultHandler handler) 


e void parse(String url, DefaultHandler handler) 


e void parse(InputStream in, DefaultHandler handler) 


解析 来 自给 定 文件 、URL 或 输入 流 的 XML 文档 ， 并 把 解析 事件 报告 给 指定 的 处 理 器 。 
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e void startDocument( ) 
e void endDocument( ) 
在 文档 的 开头 和 结尾 处 被 调用 。 
evoid startElement(String uri, String Iname, String qname, Attributes 
attr) 
e void endElement(String uri, String Iname, String qname) 
在 元 素 的 开头 和 结尾 处 被 调用 。 
参数 : uri 命名 空间 的 URI (如 果 解 析 器 是 命名 空间 感知 的 ) 
Iname 不 带 前 组 的 本 地 名 〈 如 果 解 析 器 是 命名 空间 感知 的 ) 
qname 元 素 名 (如 果 解 析 器 是 命名 空间 感知 的 )， 或 者 是 带 有 前 缀 的 限定 名 
《如 果 解 析 器 除了 报告 本 地 名 之 外 还 报告 限定 名 ) 


e void characters(char[] data, int start, int length) 


解析 需 报 告 字 符 数据 时 被 调用 。 

HH: data 字符 数据 数组 
start 在 作为 被 报告 的 字符 数据 的 一 部 分 的 字符 数组 中 ， 第 一 个 字符 的 索引 
length 被 报告 的 字符 串 的 长 度 








e int getLength() 
返回 存储 在 该 属性 集合 中 的 属性 数量 。 
e String getLocalName(int index) 
BIA ERS AR PEAY AS (OCR), REN aa A ce OZ 28 Da) AY e Fg l 
28 FAT AB 
e String getURICint index) 
返回 给 定 索引 的 属性 的 命名 空间 URI， 或 者 ， 当 该 节点 不 是 命名 空间 的 一 部 分 ， 或 解 
析 器 并 非 命名 空间 感知 时 返回 空 字 符 串 。 
e String getQName(int index) 
返回 给 定 索引 的 属性 的 限定 名 《〈 带 前 缀 )， 或 当 解 析 器 不 报告 限定 名 时 返回 空 字符 串 。 
e String getValue(int index) 
e String getValue(String qname) 
e String getValue(String uri, String Iname) 


根据 给 定 索 引 、 限 定名 或 命名 空间 URE 本 地 名 来 返回 属性 值 ; 当 该 值 不 存在 时 ,返回 nu11。 


3.6.2 ”使 用 StAX 解析 器 
StAX 解析 器 是 一 种 “ 拉 解 析 器 (pull parser)”， 与 安装 事件 处 理 器 不 同 ， 你 只 需 使 用 下 
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EE A EAS RIA CT SF : 


InputStream in = url.openStream() ; 

XMLInputFactory factory = XMLInputFactory.newInstance() ; 
XMLStreamReader parser = factory.createXMLStreamReader(in) ; 
while (parser. hasNext()) 

{ 


int event = parser.next(); 
Call parser methods to obtain event details 


} 
例如 ， 在 解析 下 面 的 片断 时 


<font> 
<name>Hel veti ca</name> 
<size units="pt'">36</size> 
</font> 


解析 器 将 产生 下 面 的 事件 : 

1) START_ELEMENT， 元 素 名 : font 
2) CHARACTERS, HA: 空白 字符 
3 ) START_ELEMENT， 元 素 名 : name 
4) CHARACTERS， 内 容 : Helvetica 
5) END_ELEMENT， 元 素 名 ，name 
6 ) CHARACTERS ， 内 容 : 空白 字符 
7) START_ELEMENT， 元 素 名 : size 
8 ) CHARACTERS, WX: 36 

9) END_ELEMENT ， 元 素 名 : size 
10) CHARACTERS, AA: 空白 字符 
11) END_ELEMENT， 元 素 名 : font 
要 分 析 这 些 属 性 值 ， 需 要 调用 XMLStreamReader 类 中 恰当 的 方法 ， 例 如 : 


String units = parser.getAttributeValue(null, “units"); 
它 可 以 获取 当前 元 素 的 units 属性 。 
默认 情况 下 ， 命 名 空间 处 理 是 启用 的 ， 你 可 以 通过 像 下 面 这 样 修改 工厂 来 使 其 无 效 : 


XMLInputFactory factory = XMLInputFactory.newInstance() ; 
factory. setProperty (XMLInputFactory.IS_NAMESPACE_AWARE, false); 


程序 清单 3-9 包含 了 用 StAX SR DT ae SE BLAS Pd ME EAP TEM TL, Bes bee 
效 的 SAX 代码 要 简短 了 许多 ， 因 为 此 时 我 们 不 必 操 心事 件 处 理 问题 。 





package stax; 


import java.i0.*; 
import java.net.*; 
import javax.xm].stream.*; 


km Aa ùo N 
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jt 

8 * This program demonstrates how to use a StAX parser. The program prints all hyperlinks of 
9 * an XHTML web page. <br> 

10 * Usage: java stax.StAXTest URL 

11 * @author Cay Horstmann 

12 * @version 1.0 2007-06-23 


uo */ 

14 public class StAXTest 

is { 

16 public static void main(String[] args) throws Exception 
17 { 

18 String urlString; 

19 if (args.length == 0) 

20 { 

21 urlString = "http: //ww.w3c.org"; 

22 System.out.printIn("Using " + urlString); 

23 } 

24 else urlString = args[0]; 

25 URL url = new URL(urlString) ; 

26 InputStream in = url.openStream() ; 

27 XMLInputFactory factory = XMLInputFactory.newInstance() ; 
28 XMLStreamReader parser = factory.createXMLStreamReader (in) ; 
29 while (parser.hasNext()) 

30 { 

31 int event = parser.next() ; 

32 if (event == XMLStreamConstants.START_ELEMENT) 

33 { 

34 if (parser.getLocalName() .equals("a")) 

35 

36 String href = parser.getAttributeValue(null, "href"); 
37 if (href != null) 

38 System. out.printIn(href) ; 

39 } 

40 } 

41 } 

42 } 

43 } 





e static XMLInputFactory newInstance() 
返回 XMLInputFactory 类 的 一 个 实例 。 

evoid setProperty(String name, Object value) 
设置 这 个 工厂 的 属性 ， 或 者 在 要 设置 的 属性 不 支持 设置 成 给 定 值 时 ， 抛 出 111egalArgument 
Exception, Java SE 的 实现 支持 下 列 Boolean 类 型 的 属性 : 
"javax.xml.stream.isValidating 为 false (默认 值 ) 时 ， 不 验证 文 

档 〈 规 范 不 要 求 必 须 文 持 )。 

"javax.xml.stream. isNamespaceAware" J true (默认 值 ) 时 ， 将 处 理 命 名 
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空间 (规范 不 要 求 必须 支持 )。 


"javax.xml.stream.isCoalescing" 为 .false (默认 值 ) 时 ， 邻 近 的 字 
符 数据 不 进行 连接 。 

"javax.xm]l . stream. isReplacingEntityReferences" 为 true 默认 值 ) 时 ， 实 体 引 用 将 
作为 字符 数据 被 替换 和 报告 。 


"javax.xml.stream.isSupportingExternalEntities" 4 true (默认 值 ) 时 ， 外 部 实体 将 
被 解析 。 规 范 对 于 这 个 属性 没有 给 
出 默认 值 。 
"javax.xml.stream.supportDTD" 为 true (默认 值 ) Wt, DTD 将 作为 
事件 被 报告 。 
e XMLStreamReader createXMLStreamReader(InputStream in) 
eXMLStreamReader createXMLStreamReader( InputStream in, String 
characterEncoding) 
e XMLStreamReader createXMLStreamReader(Reader in) 
e XMLStreamReader createXMLStreamReader(Source in) 


创建 一 个 从 给 定 的 流 、 阅 读 器 或 JAXP PRI AAT aE o 





èe boolean hasNext() 
如 果 有 男 一 个 解析 事件 ， 则 返回 true. 
eint next() 
将 解析 器 的 状态 设置 为 下 一 个 解析 事件 ， 并 返回 下 列 常量 之 一 : START_ELEMENT 
END_ELEMENT CHARACTERS START_DOCUMENT END_DOCUMENT CDATA COMMENT 
SPACE (可 和 忽略 的 空白 字符 )、PROCESSING_INSTRUCTION ENTITY_REFERENCE DTD 
e boolean isStartElement() 
e boolean isEndElement( ) 
e boolean isCharacters() 
e boolean isWhiteSpace( ) 
如 果 当 前 事件 是 一 个 开始 元 素 、 结 束 元 素 、 字 符 数据 或 空白 字符 ， 则 返回 true, 
e QName getName( ) 
e String getLocalName( ) 
获取 在 START_ELEMENT 或 END_ELEMENT 事件 中 的 元 素 的 名 字 。 
e String getText() 
返回 一 个 CHARACTERS, COMMENT 或 CDATA 事件 中 的 字符 ， 或 一 个 ENTITY_REFERENCE 
的 替换 值 ， 或 者 一 个 DTD 的 内 部 子 集 。 
e int getAttributeCount( ) 








SS 


170 Java SHR AIT ZRH 


e QName getAttributeName(int index) 

e String getAttributeLocalName(int index) 

e String getAttributeValue(int index) 
如 果 当 前 事件 是 START_ELEMENT， 则 获取 属性 数量 和 属性 的 名 字 与 值 。 

e String getAttributeValue(String namespaceURI, String name) 
如 果 当 前 事件 是 START_ELEMENT， 则 获取 具有 给 定名 称 的 属性 的 值 。 如 果 namespaceURI 
为 nu11， 则 不 检查 名 字 空 间 。 


3.7 ER XML 文档 


现在 你 已 经 知道 怎样 编写 读 取 XML 的 Java 程序 了 。 下 面 让 我 们 开始 介绍 它 的 反 向 过 
程 ， 即 产生 XML 输出。 当然， 你 可 以 直接 通过 一 系列 print 调用 ， 打 印 出 各 元 素 、 属 性 和 
文本 内 容 ， 以 此 来 编写 XML 文件 ,但 这 并 不 是 一 个 好 主意 。 这 样 的 代码 会 非常 见长 复杂 ， 
对 于 属性 值 和 文本 内 容 中 的 那些 特殊 符号 (如 :" 和 <)， 一 不 注意 就 会 出 错 。 

一 种 更 好 的 方式 是 用 文档 的 内 容 构 建 一 棵 DOM 树 ， 然 后 再 写 出 该 树 的 所 有 内 容 。 下 面 
AI) RTE ABA - 


3.7.1 不 带 命 名 空间 的 文档 
要 建立 一 棵 DOM 树 ， 你 可 以 从 一 个 空 的 文档 开始 。 通 过 调用 DocumentBuilder 类 的 
newDocument 方法 可 以 得 到 一 个 空 文档 。 


Document doc = builder.newDocument(); 


使 用 Document 类 的 createElement 方法 可 以 构建 文档 里 的 元 素 : 


Element rootElement = doc.createElement(rootName) ; 
Element childElement = doc.createElement(childName) ; 


使 用 createTextNode 方法 可 以 构建 文本 节点 . 
Text textNode = doc.createTextNode(textContents) ; 
使 用 以 下 方法 可 以 给 文档 添加 根 元 素 ， 给 父 结 点 添加 子 节点 : 


doc.appendChi 1d(rootElement) ; 
rootElement.appendChild(childElement) ; 
childElement.appendChi 1d(textNode) ; 


在 建立 DOM 树 时 ， 可 能 还 需要 设置 元 素 属 性 ， 这 只 需 调用 Element 类 的 setAttribute 
方法 即 可 : 
rootElement.setAttribute(name, value); 


3.7.2 ” 带 命 名 空间 的 文档 
如 果 要 使 用 命名 空间 ， 那 么 创建 文档 的 过 程 就 会 稍微 有 些 差异 。 
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首先 ， 需 要 将 生成 器 工厂 设置 为 是 命名 空间 感知 的 ， 然 后 再 创建 生成 化 : 


DocumentBuilderFactory factory = DocumentBui1derFactory,newInstanCe() ; 
factory. setNamespaceAware(true) ; 
builder = factory.newDocumentBui lder() ; 


然后 使 用 createElementNs 而 不 是 createElement 来 创建 所 有 节点 : 


String namespace = "http: //www.w3.org/2000/svg"; 
Element rootElement = doc.createElementNS(namespace, "svg"); 


QO A Hoe 2S ARE. WARA PAD xmI ns 前 级 的 属性 都 会 被 
自动 创建 。 例 如 ， 如 果 需 要 在 HTML 中 包含 SVG， 那 么 就 可 以 像 下 面 这 样 构建 元 素 : 


Element svgElement = doc.createElement (namespace, "svg:svg") 
当 该 元 素 被 写 人 XML 文件 时 ， 它 会 转变 为 : 
<svg:svg xmlns:svg="http: //www.w3.org/2000/svg"> 


如 果 需 要 设置 的 元 素 属 性 的 名 字 位 于 命名 空间 中 ， 那 么 可 以 使 用 Element 类 的 
setAttributeNs 方法 : 


rootElement, setAttributeNS (namespace, qualifiedName, value); 


3.7.3 5H% 


有 些 奇怪 的 是 ， 把 DOM 树 写 出 到 输出 流 中 并 非 一 件 易 事 。 最 容易 的 方式 是 使 用 可 扩展 的 
样式 表 语 言 转换 ( Extensible Stylesheet Language Transformations, XSLT) API。 关 于 XSLT 的 更 
多 信息 请 参见 3.8 节 。 当 下 ， 我 们 先 考虑 根据 生成 XML 输出 的 “ 魔 光 ”而 编写 的 代码 。 

我 们 把 “不 做 任何 操作 ”的 转换 应 用 于 文档 ， 并 且 捕 获 它 的 输出 。 为 了 将 DOCTYPE TA 
纳入 输出 ， 我 们 还 需要 将 SYSTEM 和 PUBLIC 标识 符 设置 为 输出 属性 。 


// construct the do-nothing transformation 

Transformer t = TransformerFactory.newInstance() .newTransformer () ; 

// set output properties to get a DOCTYPE node 
t.setQutputProperty(OutputKeys.DOCTYPE_SYSTEM, systemIdenti fier); 
t.setQutputProperty(OutputKeys.DOCTYPE_PUBLIC, publicIdenti fier) ; 

// set indentation 

t.setOutputProperty(OutputKeys. INDENT, "yes") ; 
t.setOutputProperty(OutputKeys METHOD, "xm]") ; 
t.setOutputProperty("{http://xm] .apache.org/xslt}indent-amount", "2"); 
// apply the do-nothing transformation and send the output to a file 
t.transform(new DOMSource(doc), new StreamResult(new FileQutputStream(file))); 


另 一 种 方式 是 使 用 LSSerializer #O, WORM, WEA PARES: 


DOMImplementation imp] = doc.getImplementation() ; 
DOMImplementationLS imp1LS = (DOMImplementationLS) imp].getFeature("LS", "3.0"); 
LSSerializer ser = implLS.createLSSerializer() ; 


如 果 需 要 空格 和 换行 ， 可 以 设置 下 面 的 标志 : 


ser.getDomConfig().setParameter("format-pretty-print”, true); 
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String str = ser.writeToString(doc) ; 


如 果 想 要 将 输出 直接 写 人 到 文件 中 ， 则 需要 一 个 LSOutput : 


LSOutput out = implLS.createLS0utput() ; 
out.setEncoding("UTF-8") ; 

out. setByteStream(Files.newOutputStream(path)) ; 
ser.write(doc, out); 


3.7.4 示例 : 生成 SVG 文件 


程序 清单 3-10 是 一 个 生成 XML 输出 的 典型 程序 。 该 程序 绘制 了 一 幅 现 代 派 绘画 ， 即 一 
组 随机 的 彩色 和 矩形 (参见 图 3-6 )。 我 们 使 用 可 伸缩 向 量 图 形 (Scalable Vector Graphics, SVG) 
来 保存 作品 。SVG 是 XML 格式 的 ， 它 使 用 设备 无 关 的 方式 描述 复杂 图 形 。 你 可 以 在 http:// 
www.w3c.org/ Graphics/SVG 找到 更 多 关于 SVG 的 信息 。 要 查看 SVG 文件 ， 只 需 使 用 任意 的 
ME EMAIN EA o 

我 们 并 没有 涉及 SVG 的 细节 。 就 我 们 的 目的 而 言 ， 我 们 只 mm 
需要 知道 怎样 表示 一 组 彩色 的 矩形 。 下 面 是 一 个 例子 : 


<?xml version="1.0" encoding="UTF-8"?> 

<!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 20000802//EN" 
"http: //www.w3.org/TR/2000/CR-SVG-20000802/DTD/svg-20000802.dtd"> 

<svg xmlns="http://www.w3.0rg/2000/svg" width="300" height="150"> 
<rect x="231" y="61" width="9" height="12" fill="#6e4a13"/> PE — 
<rect x="107" y="106" width="56" height="5" fi11="#c406be"/> 图 3-6 生成 的 现代 艺术 品 





TE ET pe 


</svg> 
正如 你 看 到 的 ， 每 个 矩形 都 被 描述 成 了 一 个 rect 节点 。 它 有 位 置 、 宽 度 、 高 度 和 填充 
色 等 属性 ， 其 中 填充 色 以 十 六 进 制 RGB 值 表 示 。 


图 注意 : SVG 大 量 使 用 了 属性 。 实 际 上 ， 某 些 属性 相当 复杂 。 例 如 ， 下 面 的 path oF: 
<path d="M 100 100 L 300 100 L 200 300 z"> 
M 是 指 “moveto ”命令 、L Æ44 “lineto”, z 48 “closepath” (!), BA, GARE 
格式 的 设计 者 不 太 信 任 XML 表示 结构 化 数据 的 能 力 。 在 你 自己 的 XML 格式 中 ， 你 可 能 
想 使 用 元 素来 替代 复杂 的 属性 。 





e Document newDocument( ) 


返回 一 个 空 文档 。 





e Element createElement(String name) 
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e Element createElementNS(String uri, String qname) 


返回 具有 给 定名 字 的 元 素 。 
e Text createTextNode(String data) 


返回 具有 给 定数 据 的 文本 节点 。 








e Node appendChild(Node child) 
TIA AMA Ae PBI. RG INAS 


to 0 tice i Le RE ae a bat 
rae JER a Or PRN Rade PEN ER rare niet 











evoid setAttribute(String name, String value) 
e void setAttributeNS(String uri, String qname, String value) 


将 有 给 定名 字 的 属性 设置 为 指定 的 值 。 


RH: uri 名 字 空 间 的 URI 或 nud] 
qname 限定 名 。 如 果 有 别名 前 级 ， 则 uri 不 能 为 null 


value 属性 值 





e static TransformerFactory newInstance() 


返回 TransformerFactory 类 的 一 个 实例 。 
e Transformer newTransformer() 


返回 Transformer 类 的 一 个 实例 ， 它 实现 了 标识 符 转 换 (不 做 任何 事情 的 转换 )。 









e void setOutputProperty(String name, String value) 
设置 输出 属性 。 标 准 输出 属性 参见 http:/www.w3.org/TR/xslt#output， 其 中 最 有 用 的 几 
个 如 下 所 示 : 
参数 : doctype-public DOCTYPE 声明 中 使 用 的 公共 ID 

doctype-system DOCTYPE 声明 中 使 用 的 系统 ID 


Indent “yes” Ba “no” 
method “xm1”“htm1”“text” 或 定制 的 字符 串 
e void transform(Source from, Result to) 


转换 一 个 XML 文档 o 






e DOMSource(Node n) 
从 给 定 的 节点 中 构建 一 个 源 。 通常 ， n 是 文档 节点 。 
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e StreamResult(File f) 
e StreamResult(OutputStream out) 
e StreamResult(Writer out) 
e StreamResult(String systemID) 
WICH. Bit, Biba AS ID (通常 是 相对 或 绝对 URL) 中 构建 流 结果 。 


3.7.5 ”使 用 StAX SH XML 文档 


在 前 一 节 中 ， 你 看 到 了 如 何 通过 写 出 DOM 树 的 方法 来 产生 XML 文件 。 如 果 这 个 DOM 
树 没有 其 他 任何 用 途 ， 那 么 这 种 方式 就 不 是 很 高 效 。 

StAX API 使 我 们 可 以 直接 将 XML 树 写 出 ， 这 需要 从 某 个 OutputStream 中 构建 一 个 
XMLStreamWriter， 就 像 下 面 这 样 : 


XMLOutputFactory factory = XMLOutputFactory.newInstance(); 
XMLStreamWriter writer = factory.createXMLStreamWriter (out) ; 


要 产生 XML 文件 头 ， 需 要 调用 

writer.writeStartDocument () 

然后 调用 

writer.writeStartElement (name) ; 

添加 属性 需要 调用 

writer.writeAttribute(name, value); 

现在 ， 可 以 通过 再 次 调用 writeStartElement 添加 新 的 子 节点 ,或 者 用 下 面 的 调用 瑟 
出 字符 : 

writer.writeCharacters(text) ; 

在 写 完 所 有 子 节 点 之 后 ， 调 用 

Writer,WriteEndElement () ; 

要 写 出 没有 子 节 点 的 元 素 〈 例 如 <img .../>)， 可 以 使 用 下 面 的 调用 

writer.writeEmptyE] ement (name) ; 

最 后 ， 在 文档 的 结尾 ， 调 用 

writer.writeEndDocument () ; 
这 个 调用 将 关闭 所 有 打开 的 元 素 。 

与 使 用 DOM/XSLT 的 方式 一 样 ， 我 们 不 必 担 心 属性 值 和 字符 数据 中 的 转 义 字符 。 但 是 ， 
我 们 仍旧 有 可 能 会 产生 非 良 构 的 XML， 例 如 具有 多 个 根 节 点 的 文档 。 并 且 ，StAX 当前 的 版 


B33 XML 175 


本 还 没有 任何 对 产生 缩 进 输出 的 文 持 。 
程序 清单 3-10 中 的 程序 展示 了 写 出 XML 的 两 种 方式 。 程 序 清 单 3-11 和 程序 清单 3-12 


展示 了 用 于 和 矩形 绘画 的 窗 体 类 和 构件 类 。 








1 package write; 


2 


3 import java.awt.*; 
4 import javax.swing.*; 


5 


* This program shows how to write an XML file. It saves a file describing a modern drawing in SVG 
* format. 
* @version 1.12 2016-04-27 
* @author Cay Horstmann 
| 
public class XMLWriteTest 
{ 
public static void main(String[] args) 


{ 


EventQueue.invokeLater(() -> 
{ 
JFrame frame = new XMLWriteFrame() ; 
frame. setTitle("XMLWriteTest') ; 
frame. setDefaul tC] oseOperation(JFrame.EXIT_ON CLOSE) ; 
frame.setVisible(true) ; 





19 


package write; 


import java.i0.*; 
import java.nio.file.*; 


import javax.swing.*; 

import javax.xml.stream.*; 

import javax.xml.transform. *; 

import javax.xml.transform.dom, *; 
import javax.xml.transform. stream. *; 


import org.w3c.dom.*; 


/** 

* A frame with a component for showing a modern drawing. 
gi 

public class XMLWriteFrame extends JFrame 


{ 


private RectangleComponent comp; 
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20 private JFileChooser chooser; 


22 public XMLWriteFrame () 


23 { 

24 chooser = new JFileChooser(); 

25 

26 // add component to frame 

27 

28 comp = new RectangleComponent () ; 

29 add (comp) ; 

30 

31 // set up menu bar 

32 

33 JMenuBar menuBar = new JMenuBar(); 

34 setJMenuBar (menuBar) ; 

35 

36 JMenu menu = new JMenu("File"); 

37 menuBar . add (menu) ; 

38 

39 JMenuItem newItem = new JMenuItem("New"); 

40 menu.add(newItem) ; 

41 newltem.addActionListener(event -> comp.newDrawing()); 

42 

43 JMenuItem saveItem = new JMenuItem("Save with DOM/XSLT"); 
44 menu.add(saveltem) ; 

45 saveltem.addActionListener(event -> saveDocument()); 

46 

47 JMenuItem saveStAXItem = new JMenultem("Save with StAX"); 
48 menu.add(saveStAXItem) ; 

49 SaveStAXItem. addActionListener(event -> saveStAX()); 

50 

51 JMenuItem exitItem = new JMenuItem("Exit"); 

52 menu. add(exitItem) ; 

53 exitItem.addActionListener(event -> System.exit(0)); 

54 pack(); 

55 } 

56 

57 /** 

58 * Saves the drawing in SVG format, using DOM/XSLT. 

59 */ 

60 public void saveDocument () 

61 { 

62 try 

63 { 

64 if (chooser.showSaveDialog(this) != JFileChooser.APPROVE_OPTION) return; 
65 File file = chooser.getSelectedFile(); 

66 Document doc = comp.buildDocument(); 

67 Transformer t = TransformerFactory.newInstance() .newTransformer() ; 
68 t.setOutputProperty (OutputKeys.DOCTYPE_SYSTEM, 

69 "http: //www.w3.org/TR/2000/CR-SVG-20000802/DTD/svg-20000802. dtd") ; 
70 t.setQutputProperty(OutputKeys.DOCTYPE_PUBLIC, "-//W3C//DTD SVG 20000802//EN") ; 
71 t.setQutputProperty(OutputKeys. INDENT, "yes"); 

n t.setQutputProperty(OutputKeys.METHOD, "xml"); 

73 t.setOutputProperty("{http://xml .apache.org/xslt}indent-amount", "2"); 
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14 t.transform(new DOMSource(doc), new StreamResult(Files.newOutputStream(file.toPath()))); 
75 

76 catch (TransformerException | IOException ex) 

77 { 

78 ex.printStackTrace(); 

79 } 

80 } 

81 

82 /** 

83 * Saves the drawing in SVG format, using StAX. 

84 */ 

85 public void saveStAX() 

86 { 

87 if (chooser.showSaveDialog(this) != JFileChooser.APPROVE_OPTION) return; 
88 File file = chooser.getSelectedFile(); 

89 XMLOutputFactory factory = XMLOutputFactory.newInstance() ; 
90 try 

91 { 

92 XMLStreamWriter writer = factory.createxXMLStreamWriter( 
93 Files. newOutputStream(file.toPath())); 

94 try 

95 { 

96 comp.writeDocument (writer) ; 

97 } 

98 finally 

99 

100 writer.close(); // Not autocloseable 

101 

102 

103 catch (XMLStreamException | IOException ex) 

104 { 

105 ex.printStackTrace() ; 





package write; 


1 

2 

3 Import java.awt.*; 

4 import java.awt.geom.*; 

5 import java.util.*; 

6 import javax.swing.*; 

7 import javax.xml.parsers.*; 
8 import javax.xml.stream.*; 
9 import org.w3c.dom.*; 


11 /** 
12 * A component that shows a set of colored rectangles. 
Bo */ 


14 public class RectangleComponent extends JComponent 


is { 





178 Java sRRK All BAJI 


16 private static final Dimension PREFERRED_SIZE = new Dimension(300, 200); 


18 private java.util.List<Rectangle2D> rects; 
19 private java.util.List<Color> colors; 

20 private Random generator; 

21 private DocumentBuilder builder; 


23 public Rectang] eComponent () 


25 rects = new ArrayList<>(); 

26 colors = new ArrayList<>(); 

27 generator = new Random(); 

28 

29 DocumentBuilderFactory factory = DocumentBuilderFactory.newInstance(); 
30 factory. setNamespaceAware(true) ; 

31 try 

32 

33 builder = factory.newDocumentBuilder(); 
34 

35 catch (ParserConfigurationException e) 

36 { 

37 e.printStackTrace(); 

38 } 

39 } 

40 

4l /** 

42 * Create a new random drawing. 

43 a 

44 public void newDrawing() 

45 { 

46 int n = 10 + generator.nextInt(20); 

47 rects.clear(); 

48 colors.clear(); 

49 for (int i = 1; 1 <= n; i++) 

50 { 

51 int x = generator.nextInt(getWidth()); 
52 int y = generator.nextInt(getHeight()); 
53 int width = generator.nextInt(getWidthQ - x); 
54 int height = generator.nextInt(getHeight() - y); 
55 rects.add(new Rectangle(x, y, width, height)); 
56 int r = generator.nextInt (256) ; 

57 int g = generator.nextInt(256) ; 

58 int b = generator.nextInt(256) ; 

59 colors.add(new Color(r, g, b)); 

60 } 

61 repaint(); 

62 } 

63 

64 public void paintComponent (Graphics g) 

65 { 

66 if (rects.size() == 0) newDrawing(); 

67 Graphics2D g2 = (Graphics2D) g; 


69 // draw all rectangles 





} 
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for (int i = 0; i < rects.size(); i++) 


} 


[** 
* Creates an SVG document of the current drawing. 
* @return the DOM tree of the SVG document 


public Document buildDocument () 


{ 


} 


/** 
* Writes an SVG document of the current drawing. 
* @param writer the document destination 


* 


g2.setPaint(colors.get(i)); 
g2.fill(rects.get(i)); 


String namespace = "http: //www.w3.0rg/2000/svg"; 

Document doc = builder.newDocument () ; 

Element svgElement = doc.createElementNS(namespace, "svg"); 
doc. appendChi ld(svgE]ement) ; 
svgElement.setAttribute("width", "" + getWidth()); 
svgElement.setAttribute("height", "" + getHeight()); 

for (int 1 = 0; i < rects.size(); i++) 


{ 
Color c = colors.get(i); 
Rectangle2D r = rects.get(i); 
Element rectElement = doc.createElementNS(namespace, "rect"); 
rectElement.setAttribute("x", "" + r.getX()); 
rectElement.setAttribute("y", "" + r.getY()); 
rectElement.setAttribute("width", "" + r.getWidth()); 
rectElement.setAttribute("height", "" + r.getHeight()); 
rectElement.setAttribute("fill", String. format ("#%06x", 

c.getRGB() & OxFFFFFF)) ; 

svgE] ement .appendChi 1d(rectE]ement) ; 

} 

return doc; 


public void writeDocument (XMLStreamWriter writer) throws XMLStreamException 


{ 


writer.writeStartDocument() ; 
writer.writeDTD("<!DOCTYPE svg PUBLIC \"-//W3C//DTD SVG 20000802//EN\" " 


+ "\"http://www.w3.org/TR/2000/CR-SVG-20000802/DTD/svg-20000802.dtd\">") ; 


writer.writeStartE]ement ("svg") ; 

writer.writeDefaul tNamespace("http: //www.w3.0rg/2000/svg") ; 
writer.writeAttribute("width", "" + getWidthQ); 
writer.writeAttribute("height", "" + getHeight()); 

for (int i = 0; i < rects.size(); i++) 


{ 


Color c = colors.get(i); 

Rectangle2D r = rects.get(i); 
writer.writeEmptyE]ement ("rect"); 
writer.writeAttribute("x", "" + r.getX()); 
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124 writer.writeAttribute("y", "" + r.getY()); 

125 writer.writeAttribute("width", "" + r.getWidth()); 
126 writer.writeAttribute("height", "" + r.getHeight()); 
127 writer.writeAttribute("fill", String. format ("#%06x", 
128 c.getRGB() & OxFFFFFF)); 

129 

130 writer.writeEndDocument(); // closes svg element 
i} 


132 
133 public Dimension getPreferredSize() { return PREFERRED SIZE; } 


134 } 





e static XMLOutputFactory newInstance() 

返回 XMLOutputFactory 类 的 一 个 实例 。 
e XMLStreamWriter createXMLStreamWriter(OutputStream in) 
eXMLStreamWriter createXMLStreamWriter(OutputStream in, String 


characterEncoding) 
e XMLStreamWriter createXMLStreamWriter(Writer in) 
è XMLStreamWriter createXMLStreamWriter(Result in) 


GES BAER. Bae JAX. 结果 的 写 出 器 。 





e void writeStartDocument( ) 

e void writeStartDocument(String xmlVersion) 

e void writeStartDocument(String encoding, String xmlVersion) 

在 文档 的 顶部 写 人 XML 处 理 指 令 。 注 意 ，encoding 参数 只 是 用 于 写 人 这 个 属性 ， 它 
不 会 设置 输出 的 字符 编码 机 制 。 

evoid setDefaultNamespace(String namespaceURI) 

e void setPrefix(String prefix, String namespaceURI ) 
设置 默认 的 命名 空间 ,或 者 具有 前 缀 的 命名 空间 。 这 种 声明 的 作用 域 只 是 当前 元 素 ， 
如 果 没 有 写 明 具体 元 素 ， 其 作用 域 为 文档 的 根 。 

e void writeStartElement(String localName) 

e void writeStartElement(String namespaceURI, String localName) 

写 出 一 个 开始 标签 ， 其 中 namespaceURI 将 用 相关 联 的 前 绥 来 代替 。 

e void writeEndElement( ) 

关闭 当前 元 素 。 


e void writeEndDocument( ) 


关闭 所 有 打开 的 元 素 。 
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e void writeEmptyElement(String localName) 
e void writeEmptyElement(String namespaceURI, String localName) 
写 出 一 个 自 闭合 的 标签 ， 其 中 namespaceURI 将 用 相关 联 的 前 缀 来 代替。 
e void writeAttribute(String localName, String value) 
e void writeAttribute(String namespaceURI, String localName, String value) 
写 出 一 个 用 于 当前 元 素 的 属性 ， 其 中 namespaceURI 将 用 相关 联 的 前 组 来 代替 。 
e void writeCharacters(String text) 
写 出 字符 数据 。 
e void writeCData(String text) 
写 出 CDATA H, 
e void writeDTD(String dtd) 
写 出 dtd 字符 串 ， 该 字 串 需要 包含 一 个 DOCTYPE 声明 。 
e void writeComment(String comment) 
与 四 一 个 注释 。 
e void close() 


RASS HAF o 


3.8 XSL 转换 


XSL 转换 (XSLT) 机 制 可 以 指定 将 XML 文档 转换 为 其 他 格式 的 规则 ， 例 如 ， 转 换 为 纯 
XÆ, XHTML 或 任何 其 他 的 XML 格式 。XSLT 通常 用 来 将 某 种 机 器 可 读 的 XML 格式 转译 
为 另 一 种 机 器 可 读 的 XML 格式 ， 或 者 将 XML 转译 为 适 于 人 类 阅读 的 表示 格式 。 

你 需要 提供 XSLT 样式 表 ， 它 描述 了 XML 文档 向 某 种 其 他 格式 转换 的 规则 。XSLT 处 理 
器 将 读 入 XML 文档 和 这 个 样式 表 ， 并 产生 所 要 的 输出 〈 参 见 图 3-7 )。 





图 3-7 应 用 XSL 转换 


XSLT 规范 很 复杂 ,已 经 有 很 多 书 描 述 了 该 主题 。 我 们 不 可 能 讨论 XSLT 的 全 部 特性 ， 
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所 以 我 们 只 能 介绍 一 个 有 代表 性 的 例子 。 你 可 以 在 Don Box FARAN ( Essential XML ) 
一 书 中 找到 更 多 的 信息 。XSLT 规范 可 以 在 http://www.w3.org/ TR/xslt 获得 。 
假设 我 们 想 要 把 有 雇员 记录 的 XML 文件 转换 成 HTML 文件 。 请 看 这 个 输入 文件 : 


<Staff> 
<emp]oyee> 
<name>Car] Cracker</name> 
<salary>75000</salary> 
<hiredate year="1987" month="12" day="15"/> 
</emp]oyee> 
<emp|oyee> 
<name>Harry Hacker</name> 
<salary>50000</salary> 
<hiredate year="1989" month="10" day="1"/> 
</emp|oyee> 
<employee> 
<name>Tony Tester</name> 
<salary>40000</salary> 
<hiredate year="1990" month="3" day="15"/> 
</emp|oyee> 
</staff> 


我 们 希望 的 输出 是 一 张 HTML 表格 : 


<table border="1"> 

<tr> 

<td>Carl Cracker</td><td>$75000.0</td><td>1987-12-15</td> 
</tr> 

<tr> 

<td>Harry Hacker</td><td>$50000.0</td><td>1989-10-1</td> 
</tr> 

<tr> 

<td>Tony Tester</td><td>$40000.0</td><td>1990-3-15</td> 
</tr> 

</table> 


具有 转换 模板 的 样式 表 形 式 如 下 : 


<?xml version="1.0" encoding="IS0-8859-1"?> 
<xsl:stylesheet 
xmlns:xsl="http://www.w3.org/1999/XSL/Transform” 
version="1.0"> 
<xs] output method="html"/> 
template, 


template 


</xslistylesheet> 

在 我 们 的 例子 中 ，xs1 :output 元 素 将 方法 设 定 为 HTML。 而 其 他 有 效 的 方法 设置 是 xm 
All text, 

下 面 是 一 个 典型 的 模板 : 


<xsl:template match="/staff/employee'> 
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<tr><xsl:apply-templates/></tr> 
</xsl:template> 


match 属性 的 值 是 一 个 XPath 表达 式 。 该 模板 声明 : 每 当 看 到 XPath 42 /staff/ employee 
中 的 一 个 节点 时 ， 将 做 以 下 操作 : 

1) 产生 字符 串 <tr>, 

2 ) 在 处 理 其 子 节点 时 ， 持 续 应 用 该 模板 。 

3 ) 当 处 理 完 所 有 子 节 点 后 ， 产 生字 符 串 </tr>, 

换 句 话说 ， 该 模板 会 生成 围绕 每 条 雇员 记录 的 HTML 表格 的 行 标记 。 

XSLT 处 理 器 以 检查 根 元 素 开 始 其 处 理 过 程 。 每 当 一 个 节点 匹配 某 个 模板 时 ， 就 会 应 
用 该 模板 (如果 匹配 多 个 模板 ， 就 会 使 用 最 佳 匹配 的 那个 ， 详 情 请 参见 http://www.w3.org/ 
TR/xslt)。 如 果 没 有 匹配 的 模板 ， 处 理 器 会 执行 默认 操作 。 对 于 文本 节点 ， 默 认 操作 是 把 
它 的 内 容 宫 括 到 输出 中 去 。 对 于 元 素 ， 默 认 操作 是 不 产生 任何 输出 ， 但 会 继续 处 理 其 子 
Tho 


下 面 是 一 个 用 来 转换 雇员 记录 文件 中 的 name 市 点 的 模板 : 


<xsl:template match="/staff/employee/name"> 
<td><xs]:apply-templates/></td> 
</xsl:template> 


正如 你 所 见 ， 模 板 产生 定 界 符 <td>. ..</td>， 并 且 让 处 理 器 递归 访问 name 元 素 的 子 
节点 。 它 只 有 一 个 子 节点 ， 即 文本 节点 。 当 处 理 器 访问 该 节点 时 ， 它 会 提取 出 其 中 的 文本 内 
容 (当然 ,前提 是 没有 其 他 匹配 的 模板 )。 

如 果 想 要 把 属性 值 复制 到 输出 中 去 ， 就 不 得 不 再 做 一 些 稍微 复杂 的 操作 了 。 下 面 是 一 个 
例子 : 


<xsl:template match="/staff/employee/hiredate"> 
<td><xs]:value-of select="@year"/>-<xs] :value-of 
select="@month"/>-<xs]:value-of select="@day"/></td> 
</xsl:template> 


当 处 理 hiredate 节点 时 ， 该 模板 会 产生 : 

1 ) FIFE <td> 

2) year 属性 的 值 

3 ) 一 个 连 字符 

4) month 属性 的 值 

5 ) 一 个 连 字符 

6 ) day 属性 的 值 

7) FIF </td> 

xsl :value-of 语句 用 于 计算 节点 集 的 字符 串 值 ， 其 中 ， 节 氮 集 由 select 属性 的 
XPath 值 指 定 。 在 这 个 例子 中 ， 路 径 是 相对 于 当前 正在 处 理 的 节点 的 相对 路 径 。 节 点 集 通 过 
将 各 个 节点 的 字符 串 值 连接 起 来 而 被 转换 成 一 个 字符 串 。 属 性 节点 的 字符 串 值 就 是 它 的 值 ， 
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文本 节点 的 字符 串 值 是 它 的 内 容 ， 元 素 节 点 的 字符 串 值 是 它 的 所 有 子 节点 〈 而 不 是 其 属性 ) 


的 字符 串 值 的 连接 。 
程序 清单 3-13 包含 了 将 带 有 雇员 记录 的 XML 文件 转换 成 HTML 表格 的 样式 表 。 





<?xml version="1.0" encoding="IS0-8859-1"?> 


1 

2 

3 <xsl:stylesheet 

4 xml ns:xsl="http://www.w3.0rg/1999/XSL/Transform" 
5 version='"1.0"> 
6 

7 

8 

9 


<xSl:output method= htm] /> 


<xsl:template match="/staff"> 
10 <table border="1"><xs1:apply-templates/></table> 
1 </xsl:template> 


13 <xsl:template match="/staff/employee'> 
14 <tr><xs]:apply-temp]lates/></tr> 
15 </xsl:template> 


17 <xsl:template match="/staff/employee/name"> 
18 <td><xsl:apply-templates/></td> 
19 </xsl:template> 


21 <xsl:template match="/staff/employee/salary"> 
22 <td>$<xs]:apply-temp]ates/></td> 
23 </xsl:template> 


15 <xsl:template match="/staff/employee/hi redate"> 

26 <td><xsl:value-of select="@year"/>-<xsl :value-of 

27 select="@month"/>-<xsl:value-of select="@day"/></td> 
28 </xsl:template> 


30 </xsl:stylesheet> 


程序 清单 3-14 显示 了 一 组 不 同 的 转换 。 其 输入 是 相同 的 XML 文件 ， 其 输出 是 我 们 熟悉 
的 属性 文件 格式 的 纯 文 本 。 


employee. 1.name=Car] Cracker 
employee.1.salary=75000.0 
employee. 1.hiredate=1987-12-15 
employee.2.name=Harry Hacker 
employee.2.salary=50000.0 
employee. 2 .hi redate=1989-10-1 
employee. 3.name=Tony Tester 
employee. 3.salary=40000.0 
employee. 3.hiredate=1990-3-15 





1 <?xml version="1.0"?> 
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<xs]:stylesheet 
xmins:xsl="http: //www.w3.org/1999/XSL/Transform" 
version="1.0"> 


<xsl:output method="text” omit-xm]l-declaration="yes" /> 


AD GD Nu mm tm A uù N 


<xsl:template match="/staff/employee'> 

10 employee.<xs]:value-of select="position()" 

11 />.mame=<xs]:value-of select="name/text()"/> 

12 employee.<xsl:value-of select="position()" 

13 />.Salary=<xs]:value-of select="salary/text()"/> 
14 employee.<xsl:value-of select="position()" 

15 />, hiredate=<xs]:value-of select="hiredate/@year" 
16 />-<xsl:value-of select="hiredate/@month" 

ı7 />-<xsl:value-of select="hiredate/@day"/> 

18 </xsl:template> 

19 

20 </xsl:stylesheet> 





该 示例 使 用 position() 函数 来 产生 以 其 父 节点 的 角度 来 看 的 当前 节点 的 位 置 。 我 们 只 
要 切换 样式 表 就 可 以 得 到 一 个 完全 不 同 的 输出 。 这 样 ， 就 可 以 安全 地 使 用 XML 来 描述 数据 
了 ， 即 便 一 些 应 用 程序 需要 的 是 其 他 格式 的 数据 ， 我 们 只 要 用 XSLT 来 产生 对 应 的 可 答 代 格 
式 即 可 。 

在 Java 平台 下 产生 XML 的 转换 极其 简单 ， 只 需 为 每 个 样式 表 设 置 一 个 转换 帮工 厂 ， 然 
后 得 到 一 个 转换 器 对 象 ， 并 告诉 它 把 一 个 源 转 换 成 结 采 。 


File styleSheet = new File(filename) ; 

StreamSource styleSource = new StreamSource(styleSheet) ; 

Transformer t = TransformerFactory.newInstance() .newTransformer(styleSource) ; 
t.transform(source, result); 


transform 方法 的 参数 是 Source H Result 接口 的 实现 类 的 对 象 。Source 接口 有 4 
个 实现 类 : 


DOMSource 
SAXSource 
StAXSource 
StreamSource 


你 可 以 从 一 个 文件 、 流 、 阅 读 器 或 URL 中 构建 StreamSource WR, RAM DOM 树 
节点 中 构建 DOMSource 对 象 。 例 如 ， 在 上 一 节 中 ， 我 们 调用 了 如 下 的 标识 转换 : 


t.transform(new DOMSource(doc), result); 

在 示例 程序 中 ， 我 们 做 了 一 些 更 有 趣 的 事情 。 我 们 并 不 是 从 一 个 现 有 的 XML 文件 开始 
工作 ， 而 是 产生 一 个 SAX XML 阅读 器 ， 通 过 产生 适合 的 SAX 事件 ， 给 人 以 解析 XML 文件 
的 错觉 。 实 际 上 ，XML 阅读 器 读 入 的 是 一 个 如 第 2 章 所 描述 的 扁平 文件 ,输入 文件 看 上 去 
是 这 样 的 : 

Carl Cracker|75000.0|1987|12|15 
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Harry Hacker|50000.0|1989|10|1 
Tony Tester|40000.0| 1990) 3|15 


处 理 输入 时 ，XML 阅读 器 将 产生 SAX 事 件 。 下 面 是 实现 了 XMLReader 接口 的 
EmployeeReader 类 的 parse 方法 的 一 部 分 代码 : 


AttributesImp] attributes = new AttributesImp] (); 
handler.startDocument () ; 

handler.startElement("", "staff", "staff", attributes); 
while ((line = in.readLine()) != null) 


handler.startElement("", "employee", "employee", attributes); 
StringTokenizer t = new StringTokenizer(line, "|"); 


handler.startElement("", "name", "name", attributes); 


String s = t.nextToken(); 
handler.characters(s.toCharArray(), 0, s.lengthQ); 


wit n " " ") ' 


handler.endElement("", "name", "name 


handler.endEVenent(”", "employee", "“employee"); 
} 


handler.endElement("", rootElement, rootE]ement) ; 
handler. endDocument () ; 


用 于 转换 项 的 SAXSource 是 从 XML 阅读 器 中 构建 的 : 


t.transform(new SAXSource(new EmployeeReader() , 
new InputSource(new FileInputStream(filename))), result); 


这 是 一 个 将 非 XML 的 遗留 数据 转换 成 XML 的 一 个 小 技巧 。 当 然 ， 大 多 数 XSLT 应 用 程 
序 都 已 经 有 了 XML 格式 的 输入 数据 ， 只 需要 在 一 个 StreamSource 对 象 上 调用 transform 
方法 即 可 ， 例 如 : 

t.transform(new StreamSource(file), result); 

其 转换 结果 是 Result 接口 的 实现 类 的 一 个 对 象 。Java 库 提 供 了 3 个 类 : 


DOMResult 
SAXResult 
StreamResult 


要 把 结果 存储 到 DOM WF, EJH DocumentBui Ider 产生 一 个 新 的 文档 节点 ， 并 将 
其 包装 到 DOMResu1t 中 


Document doc = builder.newDocument(); 
t.transform(source, new DOMResult(doc)); 


要 将 输出 保存 到 文件 中 ， 请 使 用 StreamResult; 
t.transform(source, new StreamResult(file)); 


程序 清单 3-15 包含 了 完整 的 源 代码 。 





1 package transform; 
2 
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import java.i0.*; 

import java.nio.file.*; 

import java.util.*; 

import javax.xml.transform.*; 

import javax.xm].transform.sax.*; 
import javax.xml.transform.stream. *; 
import org.xml.sax.*; 

import org.xml.sax.helpers.*; 


/** 

* This program demonstrates XSL transformations, It applies a transformation to a set of employee 
* records. The records are stored in the file employee.dat and turned into XML format. Specify 

* the stylesheet on the command line, e.g. 

* java transform.Transformlest transform/makeprop.xs] 

* @ersion 1.03 2016-04-27 


* @author Cay Horstmann 
$ 


public class TransformTest 
public static void main(String[] args) throws Exception 


{ 
Path path; 
if (args.length > 0) path = Paths.get(args[0]); 
else path = Paths.get("transform", "makehtml.xs1"); 
try (InputStream styleIn = Files.newInputStream(path) ) 
{ 


StreamSource styleSource = new StreamSource(styleln) ; 


Transformer t = TransformerFactory.newInstance() .newlransformer (styl eSource) ; 
t.setOutputProperty(OutputKeys. INDENT, "yes"); 
t.setOutputProperty(OutputKeys.METHOD, "xml "); 
t.setOutputProperty("{http://xml .apache.org/xslt}indent-amount", "2"); 


try (InputStream docIn = Files.newInputStream(Paths.get("transform", "employee. dat"))) 


t.transform(new SAXSource(new EmployeeReader(), new InputSource(docIn)), 
new StreamResult (System. out)) ; 


[** 
* This class reads the flat file employee.dat and reports SAX parser events to act as if it was 
* parsing an XML file. 
* 


class EmployeeReader implements XMLReader 
{ 


private ContentHandler handler; 


public void parse(InputSource source) throws IOException, SAXException 


InputStream stream = source.getByteStream() ; 
BufferedReader in = new BufferedReader(new InputStreamReader(stream)) ; 
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String rootElement = "staff": 
AttributesImp] atts = new AttributesImpl (); 


if (handler == null) throw new SAXException("No content handler"); 


handler.startDocument() ; 
handler.startElement("", rootElement, rootElement, atts); 
String line; 
while ((line = in.readLine()) != null) 
{ 
handler.startElement("", "employee", "employee", atts); 
StringTokenizer t = new StringTokenizer(line, "|"); 


handler.startElement("", "name", "name", atts); 
String s = t.nextToken(); 
handler.characters(s.toCharArray(), 0, s.length()); 
handler.endElement("", "name", "name"); 
handler.startElement("", "salary", "salary", atts); 
s = t.nextToken(); 
handler.characters(s.toCharArray(), 0, s.length()); 
handler.endElement("", "salary", "salary"); 


atts.addAttribute("", "year", "year", "CDATA", t.nextToken()); 
atts.addAttribute("", "month", "month", "CDATA", t.nextToken()); 
atts.addAttribute("", "day", "day", "CDATA", t.nextToken()): 
handler.startElement("", "hiredate", "hiredate", atts); 
handler.endElement("", "hiredate", "hiredate"); 

atts.clear(); 


handler.endElement("", "employee", "employee"); 


} 


handler.endElement("", rootElement, rootElement) ; 
handler. endDocument () ; 


} 


public void setContentHandler(ContentHandler newValue) 
{ 
handler = newValue; 


} 


public ContentHandler getContentHandler() 
{ 
return handler; 


} 


// the following methods are just do-nothing implementations 

public void parse(String systemId) throws IOException, SAXException {} 
public void setErrorHandler(ErrorHandler handler) {} 

public ErrorHandler getErrorHandler() { return null; } 

public void setDTDHandler(DTDHandler handler) {} 

public DTDHandler getDTDHandler() { return null; } 

public void setEntityResolver(EntityResolver resolver) {} 
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11 public EntityResolver getEntityResolver() { return null; } 
u2 public void setProperty(String name, Object value) {} 

u3 public Object getProperty(String name) { return null; } 
u4 public void setFeature(String name, boolean value) {} 

115 public boolean getFeature(String name) { return false; } 
116 } 





e Transformer newTransformer(Source styleSheet ) 


返回 一 个 transformer 类 的 实例 ， 用 来 从 指定 的 源 中 读 取 样式 表 。 





e StreamSource(File f) 


e StreamSource(InputStream in) 
e StreamSource(Reader in) 


e StreamSource(String systemID) 


自 一 个 文件 、 流 、 阅 读 器 或 系统 ID (通常 是 相对 或 绝对 URL) 构建 一 个 数据 流 源 。 





e SAXSource(XMLReader reader, InputSource source) 
构建 一 个 SAX 数据 源 ， 以 便 从 给 定 输入 源 中 获取 数据 ， 并 使 用 给 定 的 阅读 器 来 解析 输 
人 数据 。 





e void setContentHandler(ContentHandler handler) 
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e void parse(InputSource source) 


解析 来 自给 定 输入 源 的 输入 数据 ， 并 将 解析 事件 发 送 到 内 容 处 理化 。 





e DOMResult(Node n) 
自给 定 节点 构建 一 个 数据 源 。 通 常 ，n 是 一 个 新 文档 节点 。 









evoid addAttribute(String uri, String Iname, String qname, String 
type, String value) 

将 一 个 属性 添加 到 该 属性 集合 。 

RH: uri 名 字 空 间 的 URI 
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Iname 无 前 缀 的 本 地 名 


qname 种 前 级 的 限定 名 
类 型 “CDATA”、“.ID*."* IDREF”. “ IDREFS”. “NMTOKEN”. 


type 
“NMTOKENS”, “ENTITY”, “ENTITIES” 5% “NOTATION” Z— 
value 属性 值 
e void clear() 
删除 属性 集合 中 的 所 有 属性 。 


我 们 以 该 示例 结束 对 Java 库 中 的 XML 支持 特性 的 讨论 。 现 在 ， 你 应 该 对 XML 的 强大 
功能 有 了 很 好 的 了 解 ， 尤 其 是 它 的 自动 解析 、 验 证 和 强大 的 转换 机 制 。 当 然 ， 所 有 这 些 技术 
只 有 在 你 很 好 地 设计 了 XML 格式 之 后 才能 发 挥 作用 。 你 必须 确保 那些 格式 足够 丰富 ， 能 够 
表达 全 部 业务 需求 ， 随 着 时 间 的 推移 也 依旧 稳定 ， 你 的 业务 伙伴 也 愿意 接受 你 的 XML 文档 。 
这 些 问 题 要 远 比 处 理解 析 副 、DTD 或 转换 更 具 挑战 。 

在 下 一 章 ， 我 们 将 讨论 在 Java 平台 上 的 网 络 编程 ， 从 最 基础 的 网 络 套 接 字 开始 ， 逐 渐 过 
渡 到 用 于 E-mail 和 万 维 网 的 更 高 层 协议 。 
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A 连接 到 服务 器 A 获取 Web 数据 
A 实现 服务 大 A 发 送 E-mail 
A 可 中 断 套 接 字 


本 章 的 开头 部 分 将 首先 回顾 一 下 网 络 方面 的 基本 概念 ， 然 后 进一步 介绍 如 何 编写 连接 网 
络 服务 的 Java 程序 ， 并 演示 网 络 客户 端 和 服务 需 是 如 何 实 现 的 ， 最 后 将 介绍 如 何 通过 Java 
程序 发 送 E-mail， 以 及 如 何 从 Web 服务 器 获 得 信息 。 


4.1 连接 到 服务 器 


在 下 面 各 节 中 ， 你 将 会 学 习 如 何 连 接 到 服务 堪 ， 先 是 手工 用 telnet 连接 ， 然 后 是 用 Java 
程序 连接 。 


4.1.1 使 用 telnet 


telnet 是 一 种 用 于 网 络 编程 的 非常 强大 的 调试 工具 ， 你 可 以 在 命令 shell 中 输入 telnet 

来 局 动 它 。 
=| 注意: 在 Windows 中 ， 需 要 激活 telnet。 要 激活 它 ， 需 要 到 “控制 面板 "， 选 择 “ 程 序 ”， 

点 击 “ 打 开 /关闭 Windows 特性 ”"， 然 后 选择 “Telnet 客户 端 ” 复 选 框 。Windows 防火 墙 

将 会 阻止 我 们 在 本 章 中 使 用 的 很 多 网 络 端口 ， 你 可 能 需要 管理 员 账 户 才能 解除 对 它们 的 

禁用 。 

你 可 能 曾经 使 用 过 telnet 来 连接 远程 计算 机 ， 但 其 实 你 也 可 以 用 它 与 因特网 主机 所 提供 
的 其 他 服务 进行 通信 。 下 面 是 一 个 可 以 操作 的 例子 。 请 输入 : 

telnet time-a.nist.gov 13 

如 图 4-1 所 示 ， 你 可 以 得 到 与 下 面 这 一 行 相 似 的 信息 : 

57488 16-04-10 04:23:00 50 0 0 610.5 UTC(NIST) * 

上 面 例子 说 明了 什么 ? 它 说 明 你 已 经 连接 到 了 大 多 数 UNIX 计算 机 都 支持 的 “当日 时 间 ” 
服务 。 而 你 刚才 所 连接 的 那 台 服务 如 就 是 由 国家 标准 与 技术 人 研究 所 运 维 的 ， 这 家 人 研究 所 负责 
提供 饮 原 子 钟 的 计量 时 间 。( 当 然 ， 由 于 网 络 延 迟 的 缘故 ， 原 子 钟 反馈 过 来 的 时 间 并 不 完全 
准确 。) 
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$ telnet time-a.nist.gov 13 
rying 129.6.15.28.. 
onnected to time-a. nist. gov. 
Escape character is '*]'. 


7488 16-04-10 04:23:00 59 8 Ə 610.5 UTC(NIST) * 
+ ia closed by foreign host. 
$ 





图 4-1 “当日 时 间 ” 服 务 的 输出 
按照 惯例 ,“ 当 日 时 间 ” 服 务 总 是 连接 到 端口 13。 


注意 : 在 网 络 术 语 中 ， 端 口 并 不 是 指 物理 设备 ， 而 是 为 了 便于 实现 服务 器 与 客户 端 之 间 
的 通信 所 使 用 的 抽象 概念 (LA 4-2 )。 





图 4-2 连接 到 服务 器 痢 口 的 客户 端 


运行 在 远程 计算 机 上 的 服务 器 软件 不 停 地 等 待 那些 希望 与 端口 13 连接 的 网 络 请 求 。 当 
远程 计算 机 上 的 操作 系统 接收 到 一 个 请 求 与 端口 13 连接 的 网 络 数 据 包 时 ， 它 便 唤醒 正在 监 
听 网 络 连 接 请 求 的 服务 器 进程 ， 并 为 两 者 建立 连接 。 这 种 连接 将 一 直 保 持 下 去 ， 直 到 被 其 中 
AES — Fi FE. 

当 你 开始 用 time-a.nist.gov 在 端口 13 上 建立 telnet 会 话 时 ， 网 络 软件 中 有 一 段 代码 
非常 清楚 地 知道 应 该 将 字符 串 “time-a.nist.gov” 转 换 为 正确 的 IP 地 址 129.6.15.28。 随 
Ja, telnet 软件 发 送 一 个 连接 请 求 给 该 地 址 ， 请 求 一 个 到 端口 13 的 连接 。 一 旦 建立 连接 ， 远 
程 程序 便 发 送 回 一 行 数 据 ， 然 后 关闭 该 连接 。 当 然 ， 一 般 而 言 ， 客 户 端 和 服务 需 在 其 中 一 方 
关闭 连接 之 前 ， 会 进行 更 多 的 对 话 。 
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下 面 是 另 一 个 同类 型 的 试验 ， 但 它 更 加 有 趣 。 请 执行 以 下 操作 : 
telnet horstmann.com 80 


然后 非常 仔细 地 键入 以 下 内 容 : 


GET / HTTP/1.1 
Host: horstmann.com 


blank line 
也 就 是 在 末尾 按 两 次 Enter 键 。 

图 4-3 显示 了 以 上 操作 的 响应 结果 。 它 看 上 去 应 该 是 你 非常 熟悉 的 一 你 得 到 的 是 一 个 
HTML 格式 的 文本 页 ， 即 Cay Horstmann 的 主页 。 


上 述 操作 与 Web 浏览 器 访问 某 个 网 页 所 经 历 的 过 程 是 完全 一 致 的 ， 


scape character is ‘*]' 


lost: horstmann.com 


P/1.1 200 
Date: Sun, 10 To 2016 04:36:27 GMT 
Server: Apache/2. 2.24 (Unix) mod_ssl/2.2.24 OpenSSL/0.9.8e- ae a eiii mod_auth p 
pet gitar: Ae 1 mod bwlimited/1.4 mod gee 3.6 Sun-ONE-ASP/4. 
Last -Mod : 


: Thu, 17 Mar 2016 18:32:1 
-i "2590e1c - 1c47- 52e42d9a8f6868"” 


Accept-Ranges: bytes 


ontent-Length: 7239 
ontent-Type: text/html 


?xml version="1.0" encoding="UTF-8"?> 

DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" “http: //www.w3.org/TR/ 
tmL1/DTD/xhtml1-strict.dtd"> 

tml xmins="http: //www.w3.org/1999/xhtmL"><head> 

<title>Cay Horstmann's Home Page</title> 

<link href="styles.css" rel="stylesheet" type="text/css"/> 





图 4-3 {EJ telnet 访问 HTTP 端口 


它 使 用 HTTP 向 服务 


器 请 求 Web 页 面 。 当 然 ， 浏 览 器 能 够 更 精致 地 显示 HTML 代码 。 


注意 : 如 果 一 台 Web 服务 器 用 相同 的 IP 地 址 为 多 个 域 提供 宿主 环境 ， 那么 在 连接 这 台 
Web Server 时 ， 就 必须 提供 Host 键 / 值 对 。 如 果 服 务 器 只 为 单个 域 提供 宿主 环境 ， 则 可 
以 忽略 该 键 / 值 对 。 


4.1.2 用 Java 连接 到 服务 器 


程序 清单 4-1 是 我 们 的 第 一 个 网 络 程序 。 它 的 作用 与 我 们 使 用 telnet 工具 是 相同 的 ， 即 
连接 到 某 个 端口 并 打印 出 它 所 找到 的 信息 。 





1 
2 
3 
4 
5 
6 


import java.util.*; 
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7 /** 
8 * This program makes a socket connection to the atomic clock in Boulder, Colorado, and prints 
9 * the time that the server sends. 

党 


11 * @version 1.21 2016-04-27 
12 * @author Cay Horstmann 

3 */ 

14 public class SocketTest 


16 public static void main(String[] args) throws IOException 


18 try (Socket s = new Socket("time-a.nist.gov", 13); 
19 Scanner in = new Scanner(s.getInputStream(), "UTF-8")) 
20 { 

21 while (in.hasNextLine()) 

22 

23 String line = in.nextLine(); 

24 System.out.println(line); 

25 

26 } 

27 } 

28 } 


下 面 是 这 个 简单 程序 的 几 行 关键 代码 : 


Socket s = new Socket("time-a.nist.gov", 13); 
InputStream inStream = s.getInputStream() ; 


第 一 行 代码 用 于 打开 一 个 套 接 字 ， 它 也 是 网 络 软件 中 的 一 个 抽象 概念 ， 负 责 启 动 该 程 
序 内 部 和 外 部 之 间 的 通信 。 我 们 将 远程 地 址 和 端口 号 传递 给 套 接 字 的 构造 器 ， 如 果 连 接 
失败 ， 它 将 抛 出 一 个 UnknownHostException 异常 ; 如 果 存 在 其 他 问题 ， 它 将 抛 出 一 个 
IOException 异常 。 因 为 UnknownHostException 是 IOException 的 一 个 子 类 ， 况且 这 
只 是 一 个 示例 程序 ， 所 以 我 们 在 这 里 仅仅 捕获 超 类 的 异常 。 

— AER SIT, java.net.Socket 类 中 的 getInputStream 方 法 就 会 返回 一 个 
InputStream 对 象 ， 该 对 和 象 可 以 像 其 他 任何 流 对 象 一 样 使 用 。 而 一 旦 获取 了 这 个 流 ， 该 程 
序 将 直接 把 每 一 行 打印 到 标准 输出 。 这 个 过 程 将 一 直 持 续 到 流 发 送 完 毕 且 服务 器 断 开 连 接 
为 止 。 

该 程序 只 适用 于 非常 简单 的 服务 器 ， 比 如 “当日 时 间 ” 之 类 的 服务 。 在 比较 复杂 的 网 络 
程序 中 ， 客 户 端 发 送 请 求 数据 给 服务 器 ， 而 服务 器 可 能 在 响应 结束 时 并 不 立刻 断 开 连接 。 在 
本 章 的 耕 干 个 示例 程序 中 ， 都 会 看 到 我 们 是 如 何 实现 这 种 行为 的 。 

Socket 类 非常 简单 易 用 ， 因 为 Java 库 隐 藏 了 建立 网 络 连接 和 通过 连接 发 送 数据 的 复杂 
过 程 。 实 际 上 ，java.net 包 提 供 的 编程 接口 与 操作 文件 时 所 使 用 的 接口 基本 相同 。 


注意 : 本 书 所 介绍 的 内 容 仅 覆盖 了 TCP (传输 控制 协议 ) 网 络 协议 。Java 平台 另外 还 支 
持 UDP (用 户 数据 报 协议 ) 协议 ， 该 协议 可 以 用 于 发 送 数据 包 (也 称 为 数据 报 )， 它 所 需 
付出 的 开销 要 比 TCP 少 得 多 。UDP 有 一 个 重要 的 缺点 : 数据 包 无 需 按 照 顺序 传递 到 接收 


BAÈ A #8 195 


应 用 程序 ， 它 们 甚至 可 能 在 传输 过 程 中 全 部 丢失 。UDP 让 数据 包 的 接收 者 自己 负责 对 它 
们 进行 排序 ， 并 请 求 发 送 者 重新 发 送 那 些 丢失 的 数据 包 。UDP 比较 适合 于 那些 可 以 个 受 
数据 包 丢 失 的 应 用 ， 例 如 用 于 音频 流 和 视频 流 的 传输 ， 或 者 用 于 连续 测量 的 应 用 领域 。 





e Socket(String host, int port) 
构建 一 个 套 接 字 ， 用 来 连接 给 定 的 主机 和 端口 。 

e InputStream getInputStream( ) 

e OutputStream getOutputStream( ) 

获取 可 以 从 套 接 字 中 读 取 数据 的 流 ， 以 及 可 以 向 套 接 字 写 出 数据 的 流 。 
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从 套 接 字 读 取信 息 时 ， 在 有 数据 可 供 访问 之 前 ， 读 操作 将 会 被 阻塞 。 如 采 此 时 主机 不 可 
达 ， 那 么 应 用 将 要 等 待 很 长 的 时 间 ， 并且 因为 受 底层 操作 系统 的 限制 而 最 终 会 叶 致 超时 。 

对 于 不 同 的 应 用 ， 应 该 确定 合理 的 超时 值 。 然 后 调用 setSoTimeout 方法 设置 这 个 超时 
(A (单位 : 毫秒 )。 


Socket s = new Socket(. . .); 
s,setSoTimeout (10000); // time out after 10 seconds 


如 果 已 经 为 套 接 字 设 置 了 超时 值 ， 并 且 之 后 的 读 操 作 和 写 操 作 在 没有 完成 之 前 就 超过 了 
时 间 限 制 ， 那 么 这 些 操 作 就 会 抛 出 SocketTimeoutException 异常 。 你 可 以 捕获 这 个 异常 ， 
并 对 超时 做 出 反应 。 
try 
{ 
InputStream in = s.getInputStream(); // read from in 
Eag 
catch (InterruptedIOException exception) 
{ 
react to timeout 
} 
另外 还 有 一 个 超时 问题 是 必须 解决 的 。 下 面 这 个 构造 器 : 


Socket(String host, int port) 


会 一 直 无 限期 地 阻塞 下 去 ， 直 到 建立 了 到 达 主 机 的 初始 连接 为 止 。 
可 以 通过 先 构 建 一 个 无 连接 的 套 接 字 ， 然 后 再 使 用 一 个 超时 来 进行 连接 的 方式 解决 这 个 
问题 。 


Socket s = new Socket(); 
s.connect(new InetSocketAddress(host, port), timeout) ; 


如 果 你 希望 允许 用 户 在 任何 时 刻 都 可 以 中 断 套 接 字 连接 ， 请 查看 4.3 市 。 
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e Socket() 1.1 
创建 一 个 还 未 被 连接 的 套 接 字 。 

e void connect(SocketAddress address) 1.4 
将 该 套 接 字 连接 到 给 定 的 地 址 。 

evoid connect(SocketAddress address, int timeoutInMilliseconds) 1.4 
将 套 接 字 连 接 到 给 定 的 地 址 。 如 果 在 给 定 的 时 间 内 没有 啊 应 ， 则 返回 。 

e void setSoTimeout(int timeoutInMilliseconds) 1.1 
设置 该 套 接 字 上 读 请 求 的 阻塞 时 间 。 如 果 超 出 给 定时 间 ， 则 抛 出 一 个 Interrupted- 
IOException 异常 。 

e boolean isConnected() 1.4 

如 果 该 套 接 字 已 被 连接 ， 则 返回 true, 


e boolean isClosed() 1.4 


如 采 套 接 字 已 经 被 关闭 ， 则 返回 true, 
4.1.4 ”因特网 地 址 


通常 ， 不 用 过 多 考虑 因特网 地 址 的 问题 ， 它 们 是 用 一 串 数 字 表 示 的 主机 地 址 ， 一 个 因 特 
网 地 址 由 4 个 字 节 组 成 《在 IPv6 中 是 16 PF), HEA 129.6.15.28。 但 是 ， 如 果 需 要 在 主机 
名 和 因特网 地 址 之 间 进 行 转换 ， 那 么 就 可 以 使 用 InetAddress 类 。 

只 要 主机 操作 系统 支持 IPv6 格式 的 因特网 地 址 ，java.net 包 也 将 文 持 它 。 

静态 的 getByName 方法 可 以 返回 代表 某 个 主机 的 InetAddress 对 象 。 例 如 ， 

InetAddress address = InetAddress.getByName("time-a.nist.gov"); 

将 返回 一 个 InetAddress 对 象 ， 该 对 象 封 闭 了 一 个 4 字 节 的 序列 : 129.6.15.28。 然 后 ， 可 
以 使 用 getAddress 方法 来 访问 这 些 字 市 : 

byte[] addressBytes = address.getAddress(); 

一 些 访问 量 较 大 的 主机 名 通常 会 对 应 于 多 个 因特网 地 址 ， 以 实现 负载 均衡 。 例 如 ， 在 扎 
写本 书 时 ， 主 机 名 google.com 就 对 应 着 12 个 不 同 的 因特网 地 址 。 当 访问 主机 时 ,会 随机 
选取 其 中 的 一 个 。 可 以 通过 调用 getA11ByName 方法 来 获得 所 有 主机 : 

InetAddress[] addresses = InetAddress.getAllByName (host) ; 

最 后 需要 说 明 的 是 ， 有 时 我 们 可 能 需要 本 地 主机 的 地 址 。 如 果 只 是 要 求 得 到 localhost 
的 地 址 ， 那 总 会 得 到 本 地 回环 地 址 127.0.0.1， 但 是 其 他 程序 无 法 用 这 个 地 址 来 连接 到 这 台 机 
船上 。 此 时 ， 可 以 使 用 静态 的 getLocalHost 方法 来 得 到 本 地 主机 的 地 址 : 

InetAddress address = InetAddress.getLocalHost() ; 


程序 清单 4-2 是 一 段 比较 简单 的 程序 代码 。 如 果 不 在 命令 行 中 设置 任何 参数 ， 那 么 它 将 
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打印 出 本 地 主机 的 因特网 地 址 。 反 之 ， 如 果 在 命令 行 中 指定 了 主机 名 ， 那么 它 将 打印 出 该 主 
机 的 所 有 因特网 地 址 ， 例 如 


java inetAddress/InetAddressTest www.horstmann.com 





1 package inetAddress; 

2 

3 import java.i0.*; 

4 import java.net.*; 

5 

6 

7 * This program demonstrates the InetAddress class. Supply a host name as command-line argument, 
8 * or run without command-line arguments to see the address of the local host. 
9 * @ersion 1.02 2012-06-05 

10 * @author Cay Horstmann 

nu */ 

12 public class InetAddressTest 

wz { 


14 public static void main(String[] args) throws IOException 


{ 
16 if (args. length > 0) 
{ 


18 String host = args[0]; 

19 InetAddress[] addresses = InetAddress.getAl 1ByName (host) ; 
20 for (InetAddress a : addresses) 

21 System. out. print]n(a) ; 

22 } 

23 else 

24 { 

25 InetAddress localHostAddress = InetAddress.getLocalHost() ; 
26 System.out.print]n(localHostAddress) ; 

27 

28 } 

29 } 





e static InetAddress getByName(String host) 
e static InetAddress[] getAl1ByName(String host) 
为 给 定 的 主机 名 创建 一 个 InetAddress 对 象 ， 或 者 一 个 包含 了 该 主机 名 所 对 应 的 所 有 
因特网 地 址 的 数组 。 
e static InetAddress getLocalHost() 
为 本 地 主机 创建 一 个 InetAddress 对 象 。 
e byte[] getAddress() 
返回 一 个 包含 数字 型 地 址 的 字 节 数组 。 
e String getHostAddress() 
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返回 一 个 由 十 进 制 数组 成 的 字符 串 ， 各 数字 间 用 圆 点 符号 隅 开 ， 例 如 ,，“129.6.15.28 ”。 
e String getHostName( ) 


返回 主机 名 。 
4.2 ”实现 服务 器 


在 上 一 节 中 ， 我 们 已 经 实现 了 一 个 基本 的 网 络 客户 端 ， 并 且 用 它 从 因特网 上 获取 了 数 
据 。 在 这 一 节 中 ， 我 们 将 实现 一 个 简单 的 服务 器 ， 它 可 以 向 客户 端 发 送信 息 。 


4.2.1 服务 器 套 接 字 


一 旦 启动 了 服务 器 程序 ， 它 便 会 等 待 某 个 客户 端 连接 到 它 的 端口 。 在 我 们 的 示例 程序 
中 ， 我 们 选择 端口 号 8189， 因 为 所 有 标准 服务 都 不 使 用 这 个 端口 。ServerSocket 类 用 于 建 
立 套 接 字 。 在 我 们 的 示例 中 ， 下 面 这 行 命令 : 

ServerSocket s = new ServerSocket (8189) ; 

用 于 建立 一 个 负责 监控 端口 8189 的 服务 器 。 以 下 命令 : 

Socket incoming = s.accept(); 

用 于 告诉 程序 不 停 地 等 待 ， 直 到 有 客户 端 连 接 到 这 个 端口 。 一 旦 有 人 通过 网 络 发 送 了 正 
确 的 连接 请 求 ， 并 以 此 连接 到 了 端口 上 ， 该 方法 就 会 返回 一 个 表示 连接 已 经 建立 的 Socket 
对 象 。 你 可 以 使 用 这 个 对 象 来 得 到 输入 流 和 输出 流 ， 代 码 如 下 : 


InputStream inStream = incoming.getInputStream() ; 
OutputStream outStream = incoming.getOutputStream() ; 


服务 器 发 送 给 服务 器 输出 流 的 所 有 信息 都 会 成 为 客户 端 程序 的 输入 ， 同 时 来 日 客户 端 程 
序 的 所 有 输出 都 会 被 包含 在 服务 器 输入 流 中 。 

因为 在 本 章 的 所 有 示例 程序 中 ， 我 们 都 要 通过 套 接 字 来 发 送 文本 ， 所 以 我 们 将 流转 换 成 
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Scanner in = new Scanner(inStream, "UTF-8"); 
PrintWriter out = new PrintWriter(new OutputStreamWriter(outStream, "UTF-8"), 
true /* autoFlush */); 


以 下 代码 将 给 客户 端 发 送 一 条 问候 信息 : 

out.println("Hello! Enter BYE to exit."); 

当 使 用 telnet 通过 端口 8189 连接 到 这 个 服务 器 程序 时 ， 将 会 在 终端 屏幕 上 看 到 上 述 问候 
信息 。 

在 这 个 简单 的 服务 器 程序 中 ， 它 仅仅 只 是 读 取 客户 端 输入 ， 每 次 读 取 一 行 ， 并 回 送 这 一 
行 。 这 表明 程序 接收 到 了 客户 端的 输入 。 当 然 ， 实 际 应 用 中 的 服务 器 都 会 对 输入 进行 计算 并 
返回 处 理 结果 。 
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String line = in.nextLine() ; 
out ,println( "Echo: " + line); 
if (line.trim() .equals("BYE")) done = true; 


在 代码 的 最 后 ， 我 们 关闭 了 连接 进来 的 套 接 字 。 

incoming.close() ; 

这 就 是 整个 示例 代码 的 大 致 情况 。 每 一 个 服务 器 程序 ， 比 如 一 个 HTTP Web ARS ar, AB 
会 不 间断 地 执行 下 面 这 个 循环 : 

1 ) 通过 输入 数据 流 从 客户 端 接收 一 个 命令 (“get me this information”)。 

2 ) 解码 这 个 客户 端 命 令 。 

3 ) 收集 客户 端 所 请 求 的 信息 。 

4 ) 通过 输出 数据 流 发 送信 息 给 客户 端 。 
程序 清单 4-3 给 出 了 这 个 程序 的 完整 代码 。 





package server; 


import java.10.*; 
import java.net.*; 
import java.util.*; 


hea 

* This program implements a simple server that listens to port 8189 and echoes back all client 
* input. 
10 * @version 1.21 2012-05-19 


11 * @author Cay Horstmann 
* 


13 public class EchoServer 


14 { 


15 public static void main(String[] args) throws IOException 


O o ~ tO nm A u N | 一 


17 // establish server socket 

18 try (ServerSocket s = new ServerSocket (8189) ) 

19 

20 // wait for client connection 

21 try (Socket incoming = s.accept()) 

22 

23 InputStream inStream = incoming.getInputStream() ; 

24 OutputStream outStream = incoming.getOutputStream() ; 
25 

26 try (Scanner in = new Scanner(inStream, "UTF-8")) 

27 { 

28 PrintWriter out = new PrintWriter( 

29 new OutputStreamWriter(outStream, "UTF-8"), 
30 true /* autoFlush */); 

31 

32 out.print]n("Hello! Enter BYE to exit."); 


34 // echo client input 
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35 boolean done = false; 

36 while (!done && in.hasNextLine()) 

37 { 

38 String line = in.nextLine(); 

39 out.println("Echo: " + line); 

40 if (line.trim() .equals("BYE")) done = true; 


想 要 试 一 下 这 个 例子 ， 就 请 编译 并 运行 这 个 程序 。 然 后 使 用 telnet 1 Be Bi ARF F 
localhost (或 IP 地 址 127.0.0.1 ) 和 端口 8189。 

如 果 你 直接 连接 到 因特网 上 ， 那 么 世界 上 任何 人 都 可 以 访问 到 你 的 回 送 服务 器 ， 只 要 他 
们 知道 你 的 IP 地 址 和 端口 号 。 

当 你 连接 到 该 端口 时 ， 将 看 到 如 图 4-4 所 示 的 信息 : 


Hello! Enter BYE to exit. 


Fermin: 
~$ telnet localhost 8189 - 
Trying 127.0.0.1... 

Connected to localhost. 

Escape character is '^J]'. 

Hello! Enter BYE to exit. 

Hello Sailor! 

Echo: Hello Sailor! 


Connection closed by foreign host. 





图 4-4 访问 一 个 回 送 服务 天 


可 以 随意 键入 一 条 信息 ， 然 后 观察 屏幕 上 的 回 送信 息 。 输 入 BYE (全 为 大 写字 母 ) 可 以 
汤 开 连 接 ， 同 时 ， 服 务 器 程序 也 会 终止 运行 。 





e ServerSocket(int port) 


创建 一 个 监听 端口 的 服务 器 套 接 字 。 
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e Socket accept() 
等 待 连接 。 该 方法 阻塞 ( 即 ， 使 之 空闲 ) 当前 线程 直到 建立 连接 为 止 。 该 方法 返回 一 个 
Socket 对 象 ， 程 序 可 以 通过 这 个 对 象 与 连接 中 的 客户 端 进行 通信 。 

e void close() 


关闭 服务 器 套 接 字 。 


4.2.2 为 多 个 客户 端 服务 


前 面 例子 中 的 简单 服务 器 存在 一 个 问题 。 假 设 我 们 希望 有 多 个 客户 端 同时 连接 到 我 们 的 
服务 器 上 。 通 常 ， 服 务 器 总 是 不 间断 地 运行 在 服务 器 计算 机 上 ， 来自 整个 因特网 的 用 户 希 望 
同时 使 用 服务 器 。 前 面 的 简单 服务 器 会 拒绝 多 客户 端 连接 ， 使 得 某 个 用 户 可 能 会 因 长 时 间 地 
连接 服务 而 独占 服务 ， 其 实 我 们 可 以 运用 线程 的 魔力 把 这 个 问题 解决 得 更 好 。 

每 当 程 序 建立 一 个 新 的 套 接 字 连接 ， 也 就 是 说 当 调用 accept() 时 ,将 会 启动 一 个 新 的 
线程 来 处 理 服务 器 和 该 客户 端 之 间 的 连接 ， 而 主 程序 将 立即 返回 并 等 待 下 一 个 连接 。 为 了 实 
现 这 种 机 制 ， 服 务 器 应 该 具有 类 似 以 下 代码 的 循环 操作 : 

i (true) 


Socket incoming = s.accept(); 
Runnable r = new ThreadedEchoHandler(incoming) ; 


Thread t = new Thread(r); 
t.start(); 
} 


ThreadedEchoHandler 类 实现 了 Runnable 接口 ， 而 且 在 它 的 run 方法 中 包含 了 与 客 
户 端 循环 通信 的 代码 。 


class ThreadedEchoHandler implements Runnable 


public void run() 


try (InputStream inStream = incoming.getInputStream() ; 
OutputStream outStream = incoming.getOutputStream() ) 


Process input and send response 
catch(I0Exception e) 
Handle exception 


} 
} 


由 于 每 一 个 连接 都 会 启动 一 个 新 的 线程 ， 因 而 多 个 客户 端 就 可 以 同时 连接 到 服务 化 了 。 
对 此 可 以 做 个 简单 的 测试 : 
1 ) 编译 和 运行 服务 器 程序 (程序 清单 4-4 ) o 
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2) 如 图 4-5 打开 数 个 telnet 窗口 。 
3) 在 这 些 窗 口 之 间 切 换 ， 并 键入 命令 。 注 意 你 可 以 同时 通过 这 些 窗口 进行 通信 。 
4) 当 完 成 之 后 ， 切 换 到 你 启动 服务 右 程 序 的 窗口 ， 并 使 用 CTRL+C 强行 关闭 它 。 


| gle 


~$ telnet localhost 8189 
Try ia DC QT 


ii-$ telnet localhost 8189 
Trying 127.0.0.1... 
hdConnected to localhost. 
. |Escape character is ‘*]'. 
chatetto! Enter BYE to exit, 
Hello Sailor! 
Echo: Hello Sailor! 
cha 
How are you? 
~$ Echo: How are you? 
BYE 
Echo: BYE 
Connection closed by foreign host. 


~$ [| 





图 4-$ 多 个 同时 通信 的 telnet 窗口 


注意 : 在 这 个 程序 中 ， 我 们 为 每 个 连接 生成 一 个 单独 的 线程 。 这 种 方法 并 不 能 满足 高 性 
能 服务 器 的 要 求 。 为 使 服务 器 实现 更 高 的 吞吐 量 ,， 你 可 以 使 用 java.nio 包 中 一 些 特性 。 
详情 请 参见 以 下 链接 : http://www.ibm.com/developerworks/java/library/j-javaio。 





package threaded; 


import java.i0.*; 
import java.net.*; 
import java.util.*; 


/** 
* This program implements a multithreaded server that listens to port 8189 and echoes back 
* all client input. 

10 * @author Cay Horstmann 

11 * @version 1.22 2016-04-27 

2 */ 


AD o wi Cn A A u N p 
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13 public class ThreadedEchoServer 


14 { 

1 public static void main(String[] args ) 

16 { 

17 try (ServerSocket s = new ServerSocket (8189) ) 
18 { 

19 int 1 si: 

20 

21 while (true) 

22 { 

23 Socket incoming = s.accept(); 

24 System. out.printin("Spawning ”+ i); 

25 Runnable r = new ThreadedEchoHandler (incoming) ; 
26 Thread t = new Thread(r) ; 

27 t.startQ; 

28 i++} 

29 } 

30 

31 catch (IOException e) 

32 { 

33 e.printStackTrace() ; 

34 } 

35 } 

36 } 

37 

38 xk 

39 * This class handles the client input for one server socket connection. 
40 */ 

41 Class ThreadedEchoHandler implements Runnable 

a { 

43 private Socket incoming; 

44 

45 /** 

46 Constructs a handler. 

47 @param incomingSocket the incoming socket 

o */ 

49 public ThreadedEchoHandler(Socket incomingSocket) 
50 { 

51 incoming = incomingSocket; 

52 } 


54 public void run() 


56 try (InputStream inStream = incoming.getInputStream() ; 

57 OutputStream outStream = incoming.getOutputStream()) 
58 { 

59 Scanner in = new Scanner(inStream, "UTF-8"); 

60 PrintWriter out = new PrintWriter( 

61 new OutputStreamWriter(outStream, "UTF-8"), 

62 true /* autoFlush */); 

63 

64 out ,println( "Hello! Enter BYE to exit." ); 


66 // echo client input 
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67 boolean done = false; 
68 while (!done && in.hasNextLine()) 
69 
70 String line = in.nextLine(); 
71 out.printin("Echo: " + line); 
72 if (line.trim( .equals("BYE")) 
73 done = true; 
74 
75 
76 catch (IOException e) 
77 
78 e.printStackTrace(); 
79 
80 } 
8 } 
4.2.3 #A 


FHA) Chalf-close) 提供 了 这 样 一 种 能 力 : 套 接 字 连 接 的 一 端 可 以 终止 其 输出 ， 同 时 仍 
旧 可 以 接收 来 自 男 一 端的 数据 。 

这 和 是 一 种 很 典型 的 情况 ， 例 如 我 们 在 向 服务 器 传输 数据 ， 但 是 一 开始 并 不 知道 要 传输 多 
少数 据 。 在 向 文件 写 数 据 时 ， 我 们 只 需 在 数据 写 人 后 关闭 文件 即 可 。 但 是 ， 如 果 关 闭 一 个 套 
接 字 ， 那 么 与 服务 器 的 连接 将 立刻 断 开 ， 因 而 也 就 无 法 读 取 服 务 器 的 响应 了 。 

使 用 半 关 闭 的 方法 就 可 以 解决 上 述 问 题 。 可 以 通过 关闭 一 个 套 接 字 的 输出 流 来 表示 发 送 
给 服务 需 的 请 求 数据 已 经 结束 ， 但 是 必须 保持 输入 流 处 于 打开 状态 。 

如 下 代码 演示 了 如 何在 客户 端 使 用 半 关 闭 方法 : 

try (Socket socket = new Socket(host, port)) 

Scanner in = new Scanner(socket.getInputStream(), "UTF-8"); 

PrintWriter writer = new PrintWriter(socket.getOutputStream()); 

// send request data 

writer.print(. . .); 

writer. flush); 

socket. shutdownOutput () ; 

// now socket is half-closed 

// read response data 

while (in.hasNextLine() != null) { String line = in.nextLine(); ... } 


} 

服务 器 端 将 读 取 输 入 信息 ， 直 至 到 达 输 入 流 的 结尾 ， 然 后 它 再 发 送 响应 。 

当然 ， 该 协议 只 适用 于 一 站 式 ( one-shot) 的 服务 ， 例 如 HTTP 服务 ， 在 这 种 服务 中 ， 客 
户 跨 连 接 服务 器 ， 发 送 一 个 请 求 ， 捕 获 响应 信息 ， 然 后 断 开 连接 。 


p an 2、 
a. Ket TO i oe eee 
2 ee í 





e void shutdownOutput() 1.3 
将 输出 流 设 为 “ 流 结束 ”。 
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e void shutdownInput() 1.3 

e boolean isOutputShutdown() 1.4 
如 果 输 出 已 被 关闭 ， 则 返回 true, 

e boolean isInputShutdown() 1.4 
如 果 输 入 已 被 关闭 ， 则 返回 true, 


43 可 中 断 套 接 字 


当 连 接 到 一 个 套 接 字 时 ， 当 前 线程 将 会 被 阻塞 直到 建立 连接 或 产生 超时 为 止 。 同 样 地 ， 
当 通 过 套 接 字 读 写 数 据 时 ， 当 前 线程 也 会 被 阻塞 直到 操作 成 功 或 产生 超时 为 止 。 

在 交互 式 的 应 用 中 ， 也 许 会 考虑 为 用 户 提供 一 个 选项 ， 用 以 取消 那些 看 似 不 会 产生 绪 采 
的 连接 。 但 是 ， 当 线程 因 套 接 字 无 法 响应 而 发 生 阻 塞 时 ， 则 无 法 通过 调用 interrupt 来 解 
除 阻塞 。 

为 了 中 断 套 接 字 操作 ， 可 以 使 用 java.nio 包 提 供 的 一 个 特性 一 一 SocketChannel1 类 。 
可 以 使 用 如 下 方法 打开 SocketChannel: 

SocketChannel channel = SocketChannel.open(new InetSocketAddress(host, port)); 

通道 (channel) 并 没有 与 之 相关 联 的 流 。 实 际 上 ， 它 所 拥有 的 read 和 write 7 
法 都 是 通过 使 用 Buffer 对 象 来 实现 的 (关于 NIO 缓冲 区 的 相关 信息 请 参见 第 2 章 )。 
ReadableByteChannel 接口 和 Writab1leByteCchanne1 接口 都 声明 了 这 两 个 方法 。 

如 果 不 想 处 理 缓冲 区 ， 可 以 使 用 Scanner 类 从 SocketChannel 中 读 取 信息 ， 因 为 
Scanner 有 一 个 带 ReadableByteChannel BAA: 


Scanner in = new Scanner(channel, "UTF-8"); 

通过 调用 静态 方法 Channe1s .new0utputStream， 可 以 将 通道 转换 成 输出 流 。 

OutputStream outStream = Channels .newOutputStream(channel) ; 

上 述 操作 就 是 所 有 要 做 的 事情 。 当 线程 正在 执行 打开 、 读 取 或 写 人 操作 时 ， 如 有 果 线 程 发 
生 中 断 ， 那 么 这 些 操作 将 不 会 陷入 阻塞 ,而 是 以 抛 出 异常 的 方式 结束 。 

程序 清单 4-5 的 程序 对 比 了 可 中 断 套 接 字 和 阻塞 套 接 字 : 服务 器 将 连续 发 送 数 字 ， 并 在 
每 发 送 十 个 数字 之 后 停滞 一 下 。 点 击 两 个 按钮 中 的 任何 一 个 ， 都 会 启动 一 个 线程 来 连接 服务 
器 并 打印 输出 。 第 一 个 线程 使 用 可 中 断 套 接 字 ， 而 第 二 个 线程 使 用 阻塞 套 接 字 。 如 果 在 第 一 
批 的 十 个 数字 的 读 取 过 程 中 点 击 “Cancel” 按 钮 ， 这 两 个 线程 都 会 中 汤 。 





1 package interruptible; 
2 
3 Import java.awt.*; 
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4 import java.awt.event.*: 
5 import java.util.*; 

6 import java.net.*; 

7 import java.io.*: 

8 import java.nio.channels.*; 
9 import javax.swing.*; 


11 

12 * This program shows how to interrupt a socket channel. 
13 * @author Cay Horstmann 

14 * @version 1.04 2016-04-27 


is */ 

16 public class InterruptibleSocketTest 

v7 { 

18 public static void main(String[] args) 

19 { 

20 EventQueue.invokeLater(() -> 

21 { 

22 JFrame frame = new InterruptibleSocketFrame() ; 
23 frame. setTitle("InterruptibleSocketTest”) ; 

24 frame.setDefaul tC] oseOperation(JFrame.EXIT_ON CLOSE); 
25 frame. setVisible(true) ; 

26 DE 

27 } 

2 


30 Class InterruptibleSocketFrame extends JFrame 


32 private Scanner in; 

33 private JButton interruptibl] eButton; 
34 private JButton blockingButton; 

35 private JButton cancel Button; 

36 private JTextArea messages; 

37 private TestServer server; 

38 private Thread connectThread; 


4o public InterruptibleSocketFrame () 


42 JPanel northPanel = new JPanel (); 

43 add(northPanel, BorderLayout.NORTH) ; 

44 

45 final int TEXT_ROWS = 20; 

46 final int TEXT_COLUMNS = 60; 

47 messages = new JTextArea(TEXT_ROWS, TEXT_COLUMNS) ; 
48 add(new JScrol]Pane(messages)) ; 

49 

50 interruptibleButton = new JButton("Interruptible"); 
51 blockingButton = new JButton("Blocking"); 

52 

53 northPanel .add(interruptib] eButton) ; 

54 northPanel .add(blockingButton) ; 

55 

56 interruptibleButton.addActionListener(event -> 


57 { 
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interruptibleButton.setEnabled(false) ; 
blockingButton.setEnabled(false) ; 
cancel Button. setEnabled(true) ; 
connectThread = new Thread(() -> 


{ 
try 
{ 
connectInterruptibly() ; 


catch (IOException e) 


messages. append("\nInterruptibleSocketTest.connectInterruptibly: " + e); 


connectThread.start(); 


D 


blockingButton.addActionListener(event -> 
{ 
interruptibleButton. setEnabled(false) ; 
blockingButton. setEnabled(false) ; 
cancelButton. setEnabled(true); 
connectThread = new Thread(() -> 


{ 
try 
{ 


connectBlocking() ; 


} 
catch (IOException e) 
{ 


} 


messages.append("\nInterruptibleSocketTest.connectBlocking: " + e); 


connectThread.start(); 


H; 


cancelButton = new JButton("Cancel"); 
cancelButton. setEnabled(false); 
northPanel .add(cancel Button) ; 

cancel Button. addActionListener(event -> 


connectThread.interrupt() ; 
cancel Button. setEnabled(false) ; 
}); 
server = new TestServer(); 
new Thread(server).start() ; 
pack() ; 
} 


/** 

* Connects to the test server, using interruptible 1/0, 
*/ 

public void connectInterruptibly() throws IOException 

{ 


3 
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112 messages.append("Interruptible:\n") ; 

113 try (SocketChannel channel = SocketChannel.open(new InetSocketAddress("localhost", 8189))) 
114 { 

115 in = new Scanner(channel, "UTF-8"); 

116 while (!Thread.currentThread().isInterrupted()) 
117 { 

118 messages.append("Reading "); 

119 if (in. hasNextLine()) 

120 

121 String line = in.nextLine() ; 

122 messages. append(line) ; 

123 messages.append("\n"); 

124 } 

125 } 


} 
127 finally 


128 { 

129 EventQueue.invokeLater(() -> 

130 { 

131 messages.append("Channel closed\n"); 

132 interruptibleButton. setEnabl ed (true) ; 
133 blockingButton. setEnabled(true) ; 

134 }); 

135 } 

136 } 

137 

138 /** 

139 * Connects to the test server, using blocking I/0. 
140 */ 

141 public void connectBlocking() throws IOException 
mo { 

143 messages. append("Blocking:\n") ; 

144 try (Socket sock = new Socket("localhost", 8189)) 
145 

146 in = new Scanner(sock.getInputStream(), "UTF-8"); 
147 while (!Thread.currentThread().isInterrupted()) 
148 { 

149 messages.append("Reading "); 

150 if (in. hasNextLine()) 

151 { 

152 String line = in.nextLine(); 

153 messages. append(line) ; 

154 messages.append("\n") ; 

155 

156 } 

157 } 

158 finally 

159 { 

160 EventQueue.invokeLater(() -> 

161 { 

162 messages. append("Socket closed\n"); 

163 interruptibleButton. setEnabl ed(true) ; 
164 blockingButton. setEnabl ed (true) ; 


165 H: 
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/** 
* A multithreaded server that listens to port 8189 and sends numbers to the client, simulating 
* a hanging server after 10 numbers. 


ay 


class TestServer implements Runnable 


} 


public void run() 


{ 


} 


/** 


* This class handles the client input for one server socket connection. 


"y 


try (ServerSocket s = new ServerSocket (8189) ) 


whi 


{ 


} 


le (true) 


Socket incoming = s.accept(); 

Runnable r = new TestServerHandler (incoming) ; 
Thread t = new Thread(r); 

ti start(); 


catch (IOException e) 


{ 
} 


mes 


sages .append("\nTestServer.run: " + e); 


class TestServerHandler implements Runnable 


{ 


private Socket incoming; 
private int counter; 


/** 


* Constructs a handler. 
* @aram 1 the incoming socket 


"i 


public TestServerHandler(Socket i) 


{ 
} 


incoming = 1; 


public void run() 


{ 


try 
{ 


try 
{ 


OutputStream outStream = incoming.getOutputStream() ; 
PrintWriter out = new PrintWriter( 
new OutputStreamWriter(outStream, "UTF-8"), 
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220 true /* autoFlush */); 

221 while (counter < 100) 

222 { 

223 counter++; 

224 if (counter <= 10) out.printIn(counter) ; 
225 Thread. sleep(100) ; 

226 } 

227 } 

228 finally 

229 { 

230 incoming. close(); 

231 messages.append("Closing server\n'); 
232 

233 

234 catch (Exception e) 

235 { 

236 messages. append("\nTestServerHandler.run: " + e); 
237 

238 } 

239 SK 

240 } 


但 是 ， 在 第 一 批 十 个 数字 之 后 ， 就 只 能 中 断 第 一 个 线程 了 ， 第 二 个 线程 将 保持 阻塞 直到 
服务 器 最 终 关 闭 连接 (参见 图 4-6 )。 








e InetSocketAddress(String hostname, int port) 
用 给 定 的 主机 和 端口 参数 创建 一 个 地 址 对 象 ， 并 在 创建 过 程 中 解析 主机 名 。 如 果 主 机 
名 不 能 被 解析 ， 那 么 该 地 址 对 象 的 unresolved 属性 将 被 设 为 true, 

e boolean isUnresolved() 


如 果 不 能 解析 该 地 址 对 象 ， 则 返回 true. 





e static SocketChannel open(SocketAddress address) 
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打开 一 个 套 接 字 通道 ， 并 将 其 连接 到 远程 地 址 。 





e static InputStream newInputStream(ReadableByteChannel channel) 
创建 一 个 输入 流 ， 用 以 从 指定 的 通道 读 取 数 据 。 

estatic OutputStream newOutputStream(WritableByteChannel channel ) 
创建 一 个 输出 流 ， 用 以 向 指定 的 通道 写 人 数据 。 


44 获取 Web 数 


为 了 在 Java 程序 中 访问 Web 服务 器 ， 你 可 能 希望 在 更 高 的 级 别 上 进行 处 理 ， 而 不 只 是 
创建 套 接 字 连接 和 发 送 HTTP 请 求 。 在 下 面 的 各 个 小 节 中 ， 我 们 将 讨论 专用 于 此 目的 的 Java 
类 库 中 的 各 个 类 。 


4.4.1 URL 和 URI 


URL 和 URLConnection 类 封装 了 大 量 复杂 的 实现 细节 ， 这 些 细节 涉及 如 何 从 远程 站 扣 
获取 信息 。 例 如 ， 可 以 自 一 个 字符 串 构 建 一 个 URL 对 象 : 

URL url = new URL(urlString) ; 

如 果 只 是 想 获 得 该 资源 的 内 容 ， 可 以 使 用 URL 类 中 的 openStream 方法 。 该 方法 将 产 
生 一 个 InputStream 对 象 ， 然 后 就 可 以 按照 一 般 的 用 法 来 使 用 这 个 对 象 了 ， 比 如 用 它 构建 
一 个 Scanner 对 象 : 


InputStream inStream = url.openStream() ; 
Scanner in = new Scanner(inStream, "UTF-8"); 


java.net 包 对 统一 资源 定位 符 ( Uniform Resource Locator, URL) 和 统一 资源 标识 符 
(Uniform Resource Identifier，URI) 作 了 非常 有 用 的 区 分 。 

URI 是 个 纯粹 的 语法 结构 ， 包 含 用 来 指定 Web 资源 的 字符 串 的 各 种 组 成 部 分 。URL 是 
URI 的 一 个 特例 ， 它 包含 了 用 于 定位 Web 资源 的 足够 信息 。 其 他 URI， 比 如 

mailto:cay@horstmann. com 
则 不 属于 定位 符 ， 因 为 根据 该 标识 符 我 们 无 法 定位 任何 数据 。 像 这 样 的 URI 我 们 称 之 为 
URN (uniform resource name ， 统 一 资源 名 称 )。 

在 Java 类 库 中 ，URI 类 并 不 包含 任何 用 于 访问 资源 的 方法 ， 它 的 唯一 作用 就 是 解析 。 但 
FL, URL 类 可 以 打开 一 个 到 达 资 源 的 流 。 因 此 ，URL 类 只 能 作用 于 那些 Java 类 库 知道 该 如 
何 处 理 的 模式 ,例如 http:、https:、ftp:、 本 地 文件 系统 (file:) 和 JAR 文件 (jar:)。 

要 想 了 解 为 什么 对 URI 进行 解析 并 非 小 事 一 桩 ， 那 么 考虑 一 下 URL 会 变 得 多 么 复杂 。 例 如 ， 


http: /google.com?q=Beach+Chalet 
ftp: //username:password@ftp. yourserver.com/pub/file. txt 
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URI 规 范 给 出 了 标记 这 些 标识 符 的 规则 。 一 个 URI 具有 以 下 人 句法: 
[scheme: ] schemeSpecificPart [# fragment] 

上 式 中 ,，[...] 表示 可 选 部 分 ， 并且 : 和 # 可 以 被 包含 在 标识 符 内 。 

包含 scheme: 部 分 的 URI 称 为 绝对 URI, Ail, HAA URI. 

如 果 绝 对 URI 的 schemeSpecificPart 不 是 以 /开头 的 ， 我 们 就 称 它 是 不 透明 的 。 例 如 : 


mailto:cay@horstmann.com 
所 有 绝对 的 透明 URI 和 所 有 相对 URI 都 是 分 层 的 (hierarchical)。 例 如 : 


http://horstmann. com/index.html 
.«/../java/net/Socket html #Socket () 


一 个 分 层 URI 的 schemeSpecificPart 具有 以 下 结构 : 

[//authority] [path] [? query] 
在 这 里 ，[ ... ] 同样 表示 可 选 的 部 分 。 

对 于 那些 基于 服务 器 的 URI, authority 部 分 具有 以 下 形式 : 

[user-info@] host [: port] 
port 必须 是 一 个 整数 。 

RFC 2396 (标准 化 URI 的 文献 ) 还 支持 一 种 基于 注册 表 的 机 制 ， 此 时 authority 采用 
了 一 种 不 同 的 格式 。 不 过 ， 这 种 情况 并 不 常见 。 

URI 类 的 作用 之 一 是 解析 标识 符 并 将 它 分 解 成 各 种 不 同 的 组 成 部 分 。 你 可 以 用 以 下 方法 
读 取 它们 : 

getScheme 

getSchemeSpeci fi cPart 

getAuthority 

getUserInfo 

getHost 

getPort 

getPath 


getQuery 
getFragment 


URI 类 的 另 一 个 作用 是 处 理 绝对 标识 符 和 相对 标识 符 。 如 果 存 在 一 个 如 下 的 绝对 URI: 
http://docs.mycompany. com/api/java/net/ServerSocket.html 
和 一 个 如 下 的 相对 URI: 
../../java/net/Socket . html #Socket () 
那么 可 以 用 它们 组 合 出 一 个 绝对 URI: 
http://docs.mycompany.com/api/java/net/Socket. htm] #Socket () 


这 个 过 程 称 为 解析 相对 URL. 
与 此 相反 的 过 程 称 为 相对 化 (relativization)。 例 如 ， 假 设 有 一 个 基本 URI: 
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http://docs.mycompany.com/api 
和 为 一 个 URI: 
http://docs.mycompany.com/api/java/lang/String. html 
那么 相对 化 之 后 的 URI 就 是 : 
java/lang/String. html 
URI 类 同时 支持 以 下 两 个 操作 : 


relative = base, relativize(combined): 
combined = base.resolve(relative); 


4.4.2 ”使 用 URLConnection 获取 信息 


如 果 想 从 某 个 Web 资源 获取 更 多 信息 ， 那 么 应 该 使 用 URLConnection 类 ， 通 过 它 能 够 
得 到 比 基 本 的 URL 类 更 多 的 控制 功能 。 

当 操 作 一 个 URLConnection 对 象 时 ， 必 须 像 下 面 这 样 非 常 小 心地 安排 操作 步骤 : 

1) 调用 URL 类 中 的 openConnection 方法 获得 URLConnection YR: 


URLConnection connection = url.openConnection() ; 


2) 使 用 以 下 方法 来 设置 任意 的 请 求 属性 : 


setDoInput 

setDoOutput 

SetI fModi fiedSince 
setUseCaches 

setAl lowUserInteraction 
SetRequestProperty 
setConnectTimeout 
setReadTimeout 


我 们 将 在 本 节 的 稍 后 部 分 以 及 API 说 明 中 讨论 这 些 方法 。 

3) 调用 connect 方法 连接 远程 资源 : 

Connect1on,Cconnect () ; 

除了 与 服务 器 建立 套 接 字 连接 外 ， 该 方法 还 可 用 于 向 服务 器 查询 头 信息 (header information)。 

4) 与 服务 器 建立 连接 后 ， 你 可 以 查询 头 信息 。getHeaderFie1dKkey 和 getHeaderField 
这 两 个 方法 枚 举 了 消息 头 的 所 有 字段 。getHeaderFields 方法 返回 一 个 包含 了 消息 头 中 所 
有 字段 的 标准 Map 对 象 。 为 了 方便 使 用 ， 以 下 方法 可 以 查询 各 标准 字段 : 


getContentType 
getContentLength 
getContentEncoding 
getDate 
getExpiration 
getLastModi fied 


5) 最 后 ， 访 问 资源 数据 。 使 用 getInputStream 方 法 获取 一 个 输入 流 用 以 读 取 信息 
(这 个 输入 流 与 URL 类 中 的 openStream 方法 所 返回 的 流 相 同 ) 。 另 一 个 方法 getContent 在 
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实际 操作 中 并 不 是 很 有 用 。 由 标准 内 容 类 型 (比如 text/plain Al image/gif) 所 返回 的 对 
象 需要 使 用 com. sun 层次 结构 中 的 类 来 进行 处 理 。 也 可 以 注册 自己 的 内 容 处 理 器 ， 但 是 在 
本 书 中 我 们 不 讨论 这 项 技术 。 
@ 警告 : 一 些 程序 员 在 使 用 URLConnection 类 的 过 程 中 形成 了 错误 的 观念 ， 他 们 认为 
URLConnection 类 中 的 getInputStream fe getOutputStream 方法 与 Socket 类 中 的 
这 些 方 法 相似 ， 但 是 这 种 想法 并 不 十 分 正确 。URLConnection 类 具有 很 多 表象 之 下 的 神 
奇 功 能 ， 尤 其 在 处 理 请 求 和 响应 消息 头 时 。 正 因为 如 此 ， 严 格 遵循 建立 连接 的 每 个 步骤 
显得 非常 重要 。 
下 面 将 详细 介绍 一 下 URLConnection 类 中 的 一 些 方法 。 有 几 个 方法 可 以 在 与 服务 器 建 
立 连接 之 前 设置 连接 属性 ， 其 中 最 重要 的 是 setDoInput 和 setDo0utput。 在 默认 情况 下 ， 
建立 的 连接 只 产生 从 服务 器 读 取 信息 的 输入 流 ， 并 不 产生 任何 执行 写 操作 的 输出 流 。 如 有 果 想 
获得 输出 流 (例如 ， 用 于 向 一 个 Web 服务 器 提交 数据 )， 那 么 你 需要 调用 : 
connection. setDoQutput (true) ; 
接 下 来 ,也许 想 设置 某 些 请 求 头 (request header)。 请 求 头 是 与 请 求 命令 一 起 被 发 送 到 服 
Sash. PA: 


GET www. server.com/index. htm] HTTP/1.0 

Referer: http://www. somewhere. com/links.htm] 

Proxy-Connection: Keep-Alive 

User-Agent: Mozilla/5.0 (X11; U; Linux 1686; en-US; rv:1.8.1.4) 
Host: www. server. com 

Accept: text/html, image/gif, image/jpeg, image/png, */* 
Accept-Language: en 

Accept-Charset: 1s0-8859-1,*,utf-8 

Cookie: orangemi ]ano=192218887821987 


setIfModifiedSince 方法 用 于 告诉 连接 你 只 对 自 某 个 特定 日 期 以 来 被 修改 过 的 数据 
感 兴 趣 ; setUseCaches 和 setA11owUserInteraction 这 两 个 方法 只 作用 于 Applet ; 
setUseCaches 方法 用 于 命令 浏览 器 首先 检查 它 的 缓存 ; setA11owUserInteraction 
方法 则 用 于 在 访问 有 密码 保护 的 资源 时 弹出 对 话 框 ， 以 便 查询 用 户 名 和 口令 ( 见 
图 4-7 ) 

最 后 我 们 再 介绍 一 个 总 览 全 局 的 方法 : setRequestProperty， 它 可 以 用 来 设置 对 特 
定 协 议 起 作用 的 任何 “名 - 值 (name/value) X” o XF HTTP 请 求 头 的 格式 ， 请 参见 RFC 
2616， 其 中 的 某 些 参数 没有 很 好 地 建 档 ， 它 们 通常 在 程序 员 之 间 口 头 传授 。 例 如 ， 如 有 果 你 想 
访问 一 个 有 密码 保护 的 Web 页 ， 那 么 就 必须 按 如 下 步骤 操作 : 

1 ) 将 用 户 名 、 冒 号 和 密码 以 字符 串 形 式 连接 在 一 起 。 

String input = username + ":" + password; 

2) 计算 上 一 步骤 所 得 字符 串 的 Base64 编码 。( Base64 编码 用 于 将 字 节 序列 编码 成 可 打 
印 的 ASCII 字符 序列 。) 
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Base64.Encoder encoder = Base64.getEncoder() ; 
String encoding = encoder. encodeToString(input.getBytes(StandardCharsets.UTF_8)) ; 


3) 用 "Authorization" 这 个 名 字 和 "Basic"+encoding 的 值 调 用 setRequestProperty 
WE 


connection. setRequestProperty(“Authorization", 


Basic " + encoding); 


O 提示 : 我 们 上 面 介绍 的 是 如 何 访问 一 个 有 密码 保护 的 Web 页 。 如 果 想 要 通过 FTP 访问 一 
个 有 密码 保护 的 文件 时 ， 则 需要 采用 一 种 完全 不 同 的 方法 : 构建 如 下 格式 的 URL: 


ftp://username:password@ftp. yourserver.com/pub/file. txt 


Bi access Restricted Area on 
i ananin y EA 





图 4-7 网 络 密码 对 话 框 


一 旦 调用 了 connect 方法 ,就 可 以 查询 响应 头 信息 了 。 首 先 ， 我 们 将 介绍 如 何 枚 举 所 有 
响应 头 的 字段 。 似 乎 是 为 了 展示 自己 的 个 性 ， 该 类 的 实现 者 引入 了 男 一 种 迭代 协议 。 调 用 如 
下 方法 : 

String key = connection.getHeaderFieldKey(n) ; 

可 以 获得 响应 头 的 第 n 个 键 ， 其 中 n 从 1 开始 ! 如 果 n 为 0 或 大 于 消息 头 的 字段 
总 数 ， 该 方法 将 返回 nu11 值 。 没 有 哪 种 方法 可 以 返回 字段 的 数量 ， 你 必须 反复 调用 
getHeaderFieldKey 方法 直到 返回 null 为 止 。 同 样 地 ， 调 用 以 下 方法 : 


String value = Connect1on.getHeaderFiel1d(n) ; 


可 以 得 到 第 n 个 值 。 
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getHeaderFields 方法 可 以 返回 一 个 封装 了 响应 头 字 段 的 Map 对 象 。 
Map<String,List<String>> headerFields = connection.getHeaderFields(); 


下 面 是 一 组 来 自 典 型 的 HTTP 请 求 的 响应 头 字段 。 


Date: Wed, 27 Aug 2008 00:15:48 GMT 

Server: Apache/2.2.2 (Unix) 

Last-Modified: Sun, 22 Jun 2008 20:53:38 GMT 
Accept-Ranges: bytes 

Content-Length: 4813 

Connection: close 

Content-Type: text/html 


为 了 简便 起 见 ，Java 提供 了 6 个 方法 用 以 访问 最 常用 的 消息 头 类 型 的 值 ， 并 在 需要 的 时 
候 将 它们 转换 成 数字 类 型 ， 这 些 方法 的 详细 信息 请 参见 表 4-1。 返 回 类 型 为 1ong 的 方法 返回 
的 是 从 格林 尼 治 时 间 1970 年 1 月 1 日 开始 计算 的 秒 数 。 


表 4-1 用 于 访问 响应 头 值 的 简便 方法 


键 名 方法 名 返回 类 型 
Date getDate long 
Expires getExpiration long 
Last-Modified getLastModified long 
Content-Length getContentLength int 
Content-Type getContentType String 
Content-Encoding getContentEncoding String 


— 


通过 程序 清单 4-6 的 程序 ， 可 以 对 URL 连接 做 一 些 试验 。 程 序 运 行 起 来 后 ， 请 在 命令 1 
中 输入 一 个 URL 以 及 用 户 名 和 密码 (可 选 )， 例 如 
java urlConnection.URLConnectionTest http://www.yourserver.com user password 
该 程序 将 输出 以 下 内 容 : 
e 消息 头 中 的 所 有 键 和 值 。 
e 表 4-1 中 6 个 简便 方法 的 返回 值 。 
o 被 请 求 资源 的 前 10 行 信息 。 





package urlConnection; 


1 

2 

3 Import Java.i0.*,; 

4 import java.net.*; 

5 import java.nio.charset.*; 
6 import java.util.*; 

7 

8 

9 


/** 
* This program connects to an URL and displays the response header data and the first 10 lines of 
10 * the requested data. 
m * 





12 
13 


* Supply the URL and an optional username and password (for HTTP basic authentication) on the 
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* command line. 
* @version 1.11 2007-06-26 
* @author Cay Horstmann 


i 


public class URLConnectionTest 


{ 


public static void main(String[] args) 


{ 


try 
{ 


String urlName; 
if (args.length > 0) urlName = args [0]; 
else urlName = "http://horstmann. com"; 


URL url = new URL(urlName) ; 
URLConnection connection = url.openConnection(); 


// set username, password if specified on command line 
if (args.length > 2) 
{ 


String username = args(1]; 

String password = args[2]; 

String input = username + ":" + password; 

Base64. Encoder encoder = Base64.getEncoder() ; 

String encoding = encoder.encodeToString (input .getBytes (StandardCharsets .UTF_8)) ; 
connection. setRequestProperty("Authorization", "Basic ”+ encoding); 


} 


connection. connect () ; 
// print header fields 


Map<String, List<String>> headers = connection.getHeaderFields() ; 
for (Map.Entry<String, List<String>> entry : headers.entrySet()) 
{ 
String key = entry.getKey(); 
for (String value : entry.getValue()) 
System.out.printIn(key + ": " + value); 
} 


// print convenience functions 


System.out.println("---------- "Ji 

System.out.println("getContentType: " + connection.getContentType()) ; 
System.out.printIn("getContentLength: " + connection.getContentLength()) ; 
System. out.printIn("getContentEncoding: " + connection.getContentEncoding()) ; 
System.out.printIn("getDate: ”+ connection.getDate()); 
System.out.print]n("getExpiration: " + connection.getExpiration()) ; 
System.out.printIn("getLastModi fed: ”+ connection.getLastModi fied()) ; 
System. out. printIn("---------- T 


String encoding = connection.getContentEncoding() ; 
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66 if (encoding == null) encoding = "UTF-8"; 

67 try (Scanner in = new Scanner(connection.getInputStream(), encoding)) 
68 { 

69 // print first ten lines of contents 

70 

1 for (int n = 1; in.hasNextLine() && n <= 10; n+) 
72 System.out.printIn(in.nextLine()); 

73 if (in.hasNextLine()) System.out.printin(". . ."); 
74 } 

75 } 

76 catch (IOException e) 

77 

78 e.printStackTrace() ; 





e InputStream openStream( ) 
打开 一 个 用 于 读 取 资源 数据 的 输入 流 。 
e URLConnection openConnection(); 


返回 一 个 URLConnection 对 象 ， 该 对 象 负责 管理 与 资源 之 间 的 连接 。 








e void setDoInput(boolean doInput) 

e boolean getDoInput() 
如 果 doInput 为 true， 那么 用 户 可 以 接收 来 自 该 URLConnection 的 输入 。 

e void setDoOutput(boolean doOutput ) 

e boolean getDoOutput() 
如 果 doOutput 为 true， 那 么 用 户 可 以 将 输出 发 送 到 该 URLConnection, 

e void setIfModifiedSince(long time) 

e long getIfModifiedSince( ) 
属性 ifModifiedSince 用 于 配置 该 URLConnection 对 象 ， 使 它 只 获取 那些 自从 某 
个 给 定时 间 以 来 被 修改 过 的 数据 。 调 用 方法 时 需要 传人 的 time 参数 指 的 是 从 格林 尼 治 
时 间 1970 年 1 月 1 日 午夜 开始 计算 的 秒 数 。 

e void setUseCaches(boolean useCaches) 

e boolean getUseCaches() 
如 果 useCaches 为 true， 和 那么 数据 可 以 从 本 地 缓存 中 得 到 。 请 注意 ，URLConnection 
本 喘 并 不 维护 这 样 一 个 缓存 ， 缓 存 必 须 由 浏览 器 之 类 的 外 部 程序 提供 。 

e void setAllowUserInteraction(boolean allowUserInteraction) 


e boolean getAllowUserInteraction() 





i al lowserInteraction 为 true， 那 么 可 以 查询 用 户 的 口令 。 请 注意 ，URLConnection 
本 身 并 不 提供 这 种 查询 功能 。 查 询 必须 由 浏览 器 或 浏览 器 插件 之 类 的 外 部 程序 实现 。 
evoid setConnectTimeout(int timeout) 5.0 
e int getConnectTimeout() 5.0 
设置 或 得 到 连接 超时 时 限 (单位 : 毫秒 )。 如 果 在 连接 建立 之 前 就 已 经 达到 了 超时 的 时 限 ， 
那么 相关 联 的 输入 流 的 connect 方法 就 会 抛 出 一 个 SocketTimeoutException 异常 。 
e void setReadTimeout(int timeout) 5.0 
e int getReadTimeout() 5.0 
设置 读 取 数 据 的 超时 时 限 (单位 : 毫秒 ) 。 如 果 在 一 个 读 操作 成 功 之 前 就 已 经 达到 了 超 
时 的 时 限 ,， 那么 read 方法 就 会 抛 出 一 个 SocketTimeoutException 异常 。 
e void setRequestProperty(String key, String value) 
设置 请 求 头 的 一 个 字段 。 
e Map<String,List<String>> getRequestProperties() 1.4 
返回 请 求 头 属性 的 一 个 映射 表 。 相 同 的 键 对 应 的 所 有 值 被 放置 在 同一 个 列表 中 。 
e void connect() 
连接 远程 资源 并 获取 响应 头 信息 。 
e Map<String,List<String>> getHeaderFields() 1.4 
返回 响应 的 一 个 映射 表 。 相 同 的 键 对 应 的 所 有 值 被 放置 在 同一 个 列表 中 。 
e String getHeaderFieldKey(int n) 
得 到 响应 头 第 n 个 字段 的 键 。 如 果 mn 小 于 等 于 0 或 大 于 响应 头 字 段 的 总 数 ， 则 该 方法 
返回 nu11 值 。 
e String getHeaderField(int n) 
得 到 响应 头 第 n 个 字段 的 值 。 如 果 nm 小 于 等 于 0 或 大 于 响应 头 字 段 的 总 数 ， 则 该 方法 
返回 null 值 。 
èe int getContentLength() 
如 果 内 容 长 度 可 获得 ， 则 返回 该 长 度 值 ， 否 则 返回 -1。 
e String getContentType( ) 
获取 内 容 的 类 型 ， 比 如 text/plain 或 image/gif. 
e String getContentEncoding( ) 
获取 内 容 的 编码 机 制 ， 比 如 gzip。 这 个 值 不 太 常用 ， 因 为 默认 的 identity 编码 机 制 
并 不 是 用 Content-Encoding 头 来 设 定 的 。 
è long getDate() 
e long getExpiration( ) 
e long getLastModified( ) 
获取 创建 日 期 、 过 期 日 以 及 最 后 一 次 被 修改 的 日 期 。 这 些 日 期 指 的 是 从 格林 尼 治 时 间 
1970 年 1 月 1 日 午夜 开始 计算 的 秒 数 。 
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e InputStream getInputStream( ) 

e OutputStream getOutputStream( ) 
返回 从 资源 读 取信 息 或 向 资源 写 人 信息 的 流 。 

e Object getContent() 
选择 适当 的 内 容 处 理 器 ， 以 便 读 取 资 源 数据 并 将 它 转换 成 对 象 。 该 方法 对 于 读 取 诸 如 
text/plain sk image/gif 之 类 的 标准 内 容 类 型 并 没有 什么 用 处 ， 除 非 你 安装 了 自己 
A AAA ER aE o 


44.3 提交 表单 数据 


在 上 一 节 中 ， 我 们 介绍 了 如 何 从 Web 服务 器 读 取 数 据 。 现 在 ， 我 们 将 介绍 如 何 让 程序 再 
将 数据 反馈 回 Web 服务 器 和 那些 被 Web 服务 器 调用 的 程序 。 
为 了 将 信息 从 Web 浏览 器 发 送 到 Web 服务 器 ， 用 户 需要 填写 一 个 类 似 图 4-8 中 所 示 的 表单 。 
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图 4-8 HTML 表单 


当 用 户 点 击 提交 按钮 时 ， 文 本 框 中 的 文本 以 及 复 选 框 和 单 选 按钮 的 设 定 值 都 被 发 送 到 了 
Web Rat. JEN, Web 服务 器 调用 程序 对 用 户 的 输入 进行 处 理 。 





有 许多 技术 可 以 让 Web 服务 器 实现 对 程序 的 调用 。 其 中 最 广 人 所 知 的 是 Java Servlet, 
JavaServer Face、 微 软 的 ASP ( Active Server Pages， 动 态 服务 器 主页 ) 以 及 CGI (Common 
Gateway Interface， 通 用 网 关 接 口 ) 脚本 。 

服务 器 端 程序 用 于 处 理 表 单数 据 并 生成 另 一 个 HTML 页 ， 该 页 会 被 Web 服务 器 发 回 给 
浏览 器 ， 这 个 操作 过 程 我 们 在 图 4-9 中 作 了 说 明 。 返 回 给 浏览 器 的 响应 页 可 以 包含 新 的 信息 
(例如 ， 信 息 检 索 程 序 中 的 响应 页 ) 或 者 仅仅 只 是 一 个 确认 。 之 后 , Web 浏览 句 将 显示 啊 应 页 。 
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图 4-9 执行 服务 器 端 脚本 过 程 中 的 数据 流 


我 们 不 会 在 本 书 中 介绍 应 该 如 何 实现 服务 器 端 程序 ， 而 是 将 侧重 点 放 在 如 何 编写 客户 端 
程序 使 之 与 已 有 的 服务 器 端 程序 进行 交互 。 

当 表 单数 据 被 发 送 到 Web 服务 器 时 ， 数 据 到 底 由 谁 来 解释 并 不 重要 ， 可 能 是 Servlet 或 
CGI 脚本 ， 也 可 能 是 其 他 服务 器 端 技 术 。 客 户 端 以 标准 格式 将 数据 发 送 给 Web IR at, m 
Web 服务 器 则 负责 将 数据 传递 给 具体 的 程序 以 产生 啊 应 。 

在 向 Web 服务 器 发 送信 息 时 ， 通 常 有 两 个 命令 会 被 用 到 : GET 和 POST. 

在 使 用 GET 命令 时 ， 只 需 将 参数 附 在 URL 的 结尾 处 即 可 。 这 种 URL 的 格式 如 下 : 

http://host/path? query 

其 中 ， 每 个 参数 都 具有 “名 字 = 值 ” 的 形式 ， 而 这 些 参 数 之 间 用 & FIDA ZR 
值 将 遵循 下 面 的 规则 ， 使 用 URL 编码 模式 进行 编码 : 

e 保留 字符 A 到 Z、a 到 z、0 到 9， 以 及 . -~ o 

e 用 + 字符 替换 所 有 的 空格 。 
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e 将 其 他 所 有 字符 编码 为 UTF-8， 并 将 每 个 字 节 都 编码 为 % 后 面 紧 跟 一 个 两 位 的 十 六 进 
制 数 字 。 

例如 ， 寿 要 发 送 街道 名 San Francisco，CA， 可 以 使 用 San+Francisco%2c+CA， 因 为 
十 六 进 制 数 2c〈 即 十 进 制 数 44 ) 是 “,” 的 UTF-8 码 值 。 

这 种 编码 方式 使 得 在 任何 中 间 程 序 中 都 不 会 混 人 空格 ， 并 且 也 不 需要 对 其 他 特殊 字符 进 
行 转换 。 

例如 ， 就 在 写作 本 书 的 时 候 ，Google Map 网 站 (www.google.com/maps) 可 以 接受 带 
有 两 个 名 为 q 和 hl 参数 的 查询 请 求 ， 这 两 个 参数 分 别 表 示 查 询 的 位 置 和 响应 中 所 使 用 的 人 
类 语言 。 为 了 得 到 1 Market Street, San Franciso, CA 的 地 图 ， 并 且 让 响应 使 用 德语 ， 只 需 访 
问 下 面 的 URL 即 可 : 


http://www. google. com/maps?q=1+Market+Street+San+Franci scoghl=de 


在 浏览 大 中 出 现 很 长 的 查询 字符 串 很 让 人 郁闷 ， 而 且 老 式 的 浏览 器 和 代理 对 在 GET 请 求 
中 能 够 包含 的 字符 数量 做 出 了 限制 。 正 因为 此 ，P0ST 请 求 经 常用 来 处 理 具有 大 量 数据 的 表单 。 
在 POST 请 求 中 ， 我 们 不 会 在 URL 上 附着 参数 ， 而 是 从 URLConnection 中 获得 输出 流 ， 并 将 
名 / 值 对 瑟 入 到 该 输出 流 中 。 我 们 仍旧 需要 对 这 些 值 进行 URL 编码 ， 并 用 & 字符 将 它们 隔 开 。 

下 面 ， 我 们 将 详细 介绍 这 个 过 程 。 在 提交 数据 给 服务 器 端 程序 之 前 ， 首 先 需 要 创建 一 个 
URLConnection 对 象 。 


URL url = new URL("http://host/ path") ; 
URLConnection connection = url.openConnection() ; 


然后 ， 调 用 setDoOutput 方法 建立 一 个 用 于 输出 的 连接 。 

connection. setDoQutput (true); 

接着 ， 调 用 getOutputStream 方法 获得 一 个 流 ， 可 以 通过 这 个 流向 服务 器 发 送 数 据 。 
如 采 要 加 服务 咒 发 送 文本 信息 ， 那 么 可 以 非常 方便 地 将 流 包装 在 PrintWriter 对 象 中 。 

PrintWriter out = new PrintWriter(Connection,getOutputStream() "UTF-8"); 


现在 ， 可 以 回 服务 融 发 送 数据 了 。 


out.print(namel + "=" + URLEncoder.encode(valuel, "UTF-8") + "&"); 
out.print(name2 + "=" + URLEncoder.encode(value2, "UTF-8")); 


之 后 ， 关 闭 输出 流 。 

out.close(); 

最 后 ， 调 用 getInputStream 方法 读 取 服 务 器 的 响应 。 

下 面 我 们 来 实际 操作 一 个 例子 。 地 址 为 https://www.usps.com/zip4 的 网 站 包含 一 个 用 于 
查找 街道 地 址 的 邮政 编码 的 表单 ( 见 图 4-8 )。 要 想 在 Java 程序 中 使 用 这 个 表单 ， 需 要 知道 
POST 请 求 的 URL 和 参数 。 

你 可 以 通过 查看 这 个 表单 的 HTML 源码 来 获取 这 些 信息 ,但 是 通常 用 网 络 监 视 器 来 “ 突 
视 ” 发 出 的 请 求 会 更 容易 一 些 。 作 为 其 开发 工具 包 的 组 成 部 分 ， 大 多 数 浏览 器 都 具有 网 络 监 
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视 器 。 例 如 ， 图 4-10 展示 了 Firefox 网 络 监视 器 向 我 们 的 示例 网 站 提交 数据 时 的 截屏 。 你 可 


以 发 现 其 中 的 提交 URL 以 及 参数 名 和 参数 值 。 


» USPS.com® - ZIP Code™ Lookup - Mozilla Firefox 


Several addresses matched the information you provided. Perhaps you didn't enter a street number or the buiding 
has multiple units. 


| 1 MARKET ST 
| SAN FRANCISCO CA 94105-1420 





è 200 GET 

‘© 200 GET i 

o 200 GET 2 tAddress : "14+Market+Street” 
4 304 GET T tApt:™ 

o 200 GET css eey: Sats Francisco” 
o 200 GET  quicktod | ‘irbencoda:*= 

© 200 GET W zip: 

© 200 GET  tables.c 

o 200 GET 

o 200 GET ta 

o 200 GET i 


图 4-10 一 个 HTML 表单 


| Overnight. 


Not Overpriced. 


Learn more about 


| | Priority Mail Express” > 





utre |a | @64 requêtes 


- 1,388.82 1 
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在 提交 表单 数据 时 ，HTTP 头 包含 了 内 容 类 型 和 内 容 长 度 : 

Content-Type: application/x-www-form-urlencoded 

你 还 可 以 以 其 他 格式 提交 表单 。 例 如 ， 发 送 用 JavaScript 对 象 表示 法 (ISON) 表示 的 数 
据 ， 将 内 容 类 型 设置 为 application/json。 

POST 的 头 还 必须 包括 内 容 长 度 ， 例 如 : 

Content-Length: 124 

程序 清单 4-7 用 于 将 POST 数据 发 送 给 任何 脚本 ， 它 将 数据 放 在 如 下 的 properties 文件 : 


url=https://tools.usps.com/go/Zi pLookupAction. action 
tAddress=1 Market Street 

tCity=San Francisco 

sState=(A 


这 个 程序 移 除 了 url 项 ， 并 将 其 他 内 容 都 发 送 到 了 doPost 方法 。 

在 doPost 方法 中 ， 我 们 首先 打开 连接 、 调 用 setDoOutput(true) 并 打开 输出 流 。 然 
后 ， 枚 举 Map 对 象 中 的 所 有 键 和 值 。 对 每 一 个 键 - 值 对 ， 我 们 发 送 key, = FF. value 和 
& 分 隔 符 : 


out. print (key) ; 

out.print(‘='); 
out.print(URLEncoder.encode(value, "UTF-8")); 
if (more pairs) out.print('&'); 


在 从 写 出 请 求 切换 到 读 取 响 应 的 任何 部 分 时 ， 就 会 发 生 与 服务 器 的 实际 交互 。Content- 
Length 头 被 设置 为 输出 的 尺寸 ， 而 Content-Type 头 被 设置 为 application/x-www-- 
form-urlencoded， 除 非 指 定 了 不 同 的 内 容 类 型 。 这 些 头 信息 和 数据 都 被 发 送 给 服务 器 ， 然 
后 ， 啊 应 头 和 服务 硕 啊 应 会 被 读 取 ， 并 可 以 被 查询 。 在 我 们 的 示例 程序 中 ， 这 种 切换 发 生 在 
对 connection.getCcontentEncoding() 的 调用 中 。 

在 读 取 啊 应 过 程 中 会 碰 到 一 个 问题 。 如 果 服 务 器 端 出 现 错误 ， 那 么 调用 connection. 
getInputStream( ) 时 就 会 抛 出 一 个 FileNotFoundException 异常 。 但 是 ， 此 时 服务 器 
仍然 会 加 浏览 絮 返 回 一 个 错误 页 面 (例如 ， 常 见 的 “错误 404- 找 不 到 该 页 ”)。 为 了 捕捉 这 
个 错误 页 ， 可 以 调用 getErrorStream 方法 ， 


InputStream err = connection.getErrorStream() ; 
注意 : getErrorStream 方法 与 这 个 程序 中 的 许多 其 他 方法 一 样 ， 属 于 URLConnection 
类 的 子 类 HttpURLConnection。 如 果 要 创建 以 http:/V 或 https:// FAH URL, A 
么 可 以 将 所 产生 的 连接 对 象 强制 转型 为 HttpURLConnection。 
在 将 POST 数据 发 送 给 服务 器 时 ， 服 务 器 端 程序 产生 的 啊 应 可 能 是 redirect:， 后 面 跟着 一 
个 完全 不 同 的 UREL， 该 URL 应 该 被 调用 以 获取 实际 的 信息 。 服 务 器 可 以 这 么 做 ， 因 为 这 些 
言 息 位 于 他 处 ,或 者 提供 了 一 个 可 以 作为 书签 标记 的 URL。HttpURLConnection 类 在 大 多 





数 情 况 下 可 以 处 理 这 种 重 定 回 。 


注意 : 如 果 cookie 需要 在 重 定 向 中 从 一 个 站 点 发 送 给 另 一 个 站 点 ， 那 么 你 可 以 像 下 面 这 
样 配 置 一 个 全 局 的 cookie 处 理 器 : 


CookieHandler.setDefault(new CookieManager(null, CookiePolicy.ACCEPT_ALL)) ; 
RE, cookie 就 可 以 被 正确 地 包含 在 重 定向 请 求 中 了 。 


尽管 重 定 向 通常 是 自动 处 理 的 ， 但 是 有 些 情 况 下 ， 你 需要 自己 完成 重 定向 。 例 如 ， 在 
HTTP 和 HTTPS 之 间 的 自动 重 定 向 因为 安全 原因 而 不 被 支持 。 重 定向 还 会 因 更 细微 的 原因 而 
失败 。 例 如 ， 邮 政 编码 服务 在 User-Agent 请 求 参 数 包 含 字 符 串 Java 时 无 法 工作 ， 这 可 能 
是 因为 邮政 局 不 想 为 程序 自动 产生 的 请 求 服务 。 尽 管 可 以 在 最 初 的 请 求 中 将 用 户 代理 设置 为 
其 他 的 字符 串 ， 但 是 这 项 设置 在 自动 重 定 向 中 并 没有 用 到 。 自 动 重 定向 总 是 会 发 送 包 含 单词 
Java 的 通用 用 户 代 理 字符 串 。 

在 这 些 情况 下 ， 可 以 人 工 实现 重 定向 。 在 连接 到 服务 器 之 前 ， 将 自动 重 定向 关闭 : 

Connection,.SsetInstanCeFo11owRedi rects(false) ; 

在 发 送 请 求 之 后 ， 获 取 啊 应 码 : 

int responseCode = connection.getResponseCode() ; 


检查 它 是 否 是 下 列 值 之 一 : 


HttpURLConnection.HTTP_MOVED_PERM 
HttpURLConnection.HTTP_MOVED_TEMP 
HttpURLConnection.HTTP_SEE_OTHER 


如 果 是 这 些 值 之 一 ， 那 么 获取 Location 响应 头 ， 以 获得 重 定向 的 URL. Ala, BITE 
并 创建 到 新 的 URL 的 连接 : 


String location = connection. getHeaderField("Location") ; 
if (location != null) 


i 


URL base = connection.getURL() ; 
connection.disconnect() ; 
connection = (HttpURLConnection) new URL(base, location) .openConnection() ; 
GEY 
每 当 需 要 从 某 个 现 有 的 Web 站 点 查询 信息 时 ， 该 程序 所 展示 的 处 理 技术 就 会 显得 很 有 
用 。 只 需 找 出 需要 发 送 的 参数 ， 然 后 从 回复 信息 中 剔除 HTML 和 其 他 不 必要 的 信息 。 


注意 : 正如 你 所 看 到 的 ， 可 以 使 用 Java 库 的 类 来 与 网 页 交互 ， 但 是 用 起 来 并 非特 别 方便 。 
可 以 考虑 使 用 其 他 的 库 ， 例 如 Apach HttpClient(http://hc.apache.org/httpcomponents-client-ga) 





1 package post; 
2 
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import java.io. *; 
import java.net. *; 
import java.nio.file.*; 
import java.util.*; 


/** 


* This program demonstrates how to use the URLConnection class for a POST request. 
* @version 1.40 2016-04-24 
* @author Cay Horstmann 


"/ 


public class PostTest 


{ 


public static void main(String[] args) throws IOException 


{ 


public static String doPost(URL url, Map<Object, Object> nameValuePairs, String userAgent, 


{ 


String propsFilename = args.length > 0 ? args[0] : "post/post.properties",; 
Properties props = new Properties(); 

try (InputStream in = Files.newInputStream(Paths.get(propsFi]ename) )) 

{ 


props. load(in) ; 


String urlString = props.remove("url").toString(Q) ; 
Object userAgent = props. remove("User-Agent") ; 
Object redirects = props.remove("redirects") ; 
CookieHandler.setDefault(new CookieManager(null, CookiePolicy.ACCEPT_ALL)); 
String result = doPost(new URL(urlString), props, 

userAgent == null ? null : userAgent.toString(), 

redirects == null ? -1 : Integer. parseInt(redirects.toString())); 
System.out.printIn(result) ; 


* Do an HTTP POST. 

* @param url the URL to post to 

* @param nameValuePairs the query parameters 

* @param userAgent the user agent to use, or null for the default user agent 
* @param redirects the number of redirects to follow manually, or -1 for automatic redirects 
* @return the data returned from the server 


int redirects) 
throws IOException 


HttpURLConnection connection = (HttpURLConnection) url .openConnection() ; 
if (userAgent != null) 
connection. setRequestProperty("User-Agent", userAgent) ; 


if (redirects >= 0) 
connection. setInstanceFol ]owRedi rects (false) ; 


connection. setDoQutput (true) ; 
try (PrintWriter out = new PrintWriter(connection.getOutputStream())) 


boolean first = true; 


for (Map.Entry<Object, Object> pair : nameValuePairs.entrySet()) 
{ 
if (first) first = false; 
else out.print('&'); 
String name = pair.getKey().toString(); 
String value = pair.getValue().toString(); 
out. print (name) ; 
out.print('='); 
out.print(URLEncoder.encode(value, "UTF-8")); 
} 
} 
String encoding = connection. getContentEncoding() ; 
if (encoding == null) encoding = "UTF-8"; 


if (redirects > 0) 
{ 
int responseCode = connection. getResponseCode() ; 
if (responseCode == HttpURLConnection.HTTP_MOVED_PERM 
|| responseCode == HttpURLConnection.HTTP_MOVED_TEMP 
|| responseCode == HttpURLConnection.HTTP_SEE_OTHER) 
{ 
String location = connection.getHeaderField("Location’) ; 
if (location != null) 


URL base = connection. getURL(); 
connection.disconnect() ; 
return doPost(new URL(base, location), nameValuePairs, userAgent, redirects - 1); 


} 
} 
else if (redirects == 0) 


throw new I0Exception("Too many redirects”); 


} 


StringBuilder response = new StringBuilder() ; 
try (Scanner in = new Scanner(connection.getInputStream(), encoding) ) 


while (in. hasNextLine()) 

{ 
response. append(in.nextLine()) ; 
response. append("\n"); 


} 
catch (IOException e) 
{ 
InputStream err = connection.getErrorStream() ; 
if (err == null) throw e; 
try (Scanner in = new Scanner(err)) 
{ 
response. append(in.nextLine()); 
response. append("\n") ; 


} 
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111 } 

112 

113 return response. toString); 
114 

115 } 






e InputStream getErrorStream( ) 


返回 一 个 流 ， 通 过 这 个 流 可 以 读 取 Web 服务 需 的 错误 信息 。 





e static String encode(String s, String encoding) 1.4 
采用 指定 的 字符 编码 模式 (推荐 使 用 “ UTF-8”) 对 字符 串 s 进行 编码 ， 并 返回 它 的 
URL 编码 形式 。 在 URL R, A'n "a'-'z', "0 一 "9','-','_','.' 和 '*' 
等 字符 保持 不 变 ， 空 格 被 编码 成 小， 所 有 其 他 字符 被 编码 成 "%XY" 形式 的 字 节 序列 ， 
其 中 0xXY 为 该 字 节 十 六 进 制 数 。 









e static string decode(String s, String encoding) 1.4 


采用 指定 编码 模式 对 已 编码 字符 串 s 进行 解码 ， 并 返回 结果 。 


4.5 发送 E-mail 


过 去 ， 编 写 程序 通过 创建 到 SMTP 专用 的 端口 25 来 发 送 邮 件 是 一 件 很 简单 的 事 。 简 单 
邮件 传输 协议 用 于 描述 E-mail 消息 的 格式 。 一 旦 连接 到 服务 器 ， 就 可 以 发 送 一 个 邮件 报头 
(采用 SMTP 格式 ， 该 格式 很 容易 生成 )。 紧 随 其 后 的 是 邮件 消息 。 

以 下 是 操作 的 详细 过 程 。 

1 ) 打开 一 个 到 达 主 机 的 套 接 字 : 


Socket s = new Socket("mail.yourserver.com", 25); // 25 is SMTP 
PrintWriter out = new PrintWriter(s.getOutputStream(), "UTF-8"); 


HELO sending host 

MAIL FROM: sender e-mail address 
RCPT 10: recipient e-mail address 
DATA 

Subject: subject 


(blank line) 
mail message (any number of lines) 


QUIT 
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SMTP 规范 (RFC 821) 规定 ， 每 一 行 都 要 以 Nr 再 紧 跟 一 个 \n 来 结尾 。 
SMTP 曾经 总 是 例行公事 般 地 路 由 任何 人 的 E-mail， 但 是 ， 在 蠕虫 泛滥 的 今天 ， 许 多 服 


务 右 都 内 置 了 检查 功能 ， 并 且 只 接受 来 自 授信 用 户 或 授信 IP 地 址 范围 的 请 求 。 其 中 ， 认 证 通 
常 是 通过 安全 套 接 字 连接 来 实现 的 。 


实现 人 工 认 证 模式 的 代码 非常 见长 乏味 ， 因 此 ， 我 们 将 展示 如 何 利 用 JavaMail API 在 


Java 程序 中 发 送 E-mail。 


可 以 从 www.oracle.com/technetwork/java/javamail 处 下 载 JavaMail， 然 后 将 它 解压 到 便 盘 


上 的 某 处 。 


时 ， 


如 果 要 使 用 JavaMail， 则 需要 设置 一 些 和 邮件 服务 需 相 关 的 属性 。 例 如 ， 在 使 用 GMail 
需要 设置 : 


mail.transport.protocol=smtps 
mail.smtps.auth=true 
mail.smtps.host=smtp.gmail.com 

mail. smtps.user=cayhorstmann@gmai | .Com 


我 们 的 示例 程序 是 从 一 个 属性 文件 中 读 取 这 些 属 性 值 的 。 
出 于 安全 的 原因 ， 我 们 没有 将 密码 放 在 属性 文件 中 ， 而 是 要 求 提 示 用 户 需 要 输入 。 
首先 要 谈 和 人 属性 文件 ， 然 后 像 下 面 这 样 获 取 一 个 邮件 会 话 : 


Session mailSession = Session.getDefaultInstance(props) ; 


接 痢 ， 用 恰当 的 发 送 者 、 接 受 者 、 主 题 和 消息 文本 来 创建 消息 : 


然后 


MimeMessage message = new MimeMessage(mailSession) ; 
message.setFrom(new InternetAddress(from)) ; 

message. addRecipient(RecipientType.T0, new InternetAddress(to)); 
message. SsetSubject (subject); 

message. setText (builder. toString()); 


将 消 县 发 送 走 : 


Transport tr = mailSession.getTransport() ; 
tr.connect(null, password) ; 

tr.sendMessage(message, message.getAl lRecipients()); 
tr.close(); 


程序 清单 4-8 中 的 程序 是 从 具有 下 面 这 种 格式 的 文本 文件 中 读 取 消息 的 : 
Sender Recipient Subject Message text (any number of lines) 
要 运行 该 程序 ， 需 要 键入: 


java -classpath .:path/to/mail.jar path/to/message. txt 


Herp, mail. jar f JavaMail 的 JAR 文件 ( Windows 用 户 注 意 : 记 住 在 类 路 径 中 要 输入 分 
号 而 不 是 冒号 )。 


者 。 


到 撰写 本 章 时 为 止 ，GMail 还 不 会 检查 信息 的 真实 性 ， 即 你 可 以 输入 任何 你 喜欢 的 发 送 
( 当 你 下 一 次 收 到 来 自 president@whitehouse.gov 的 E-mail 消息 邀请 你 盛装 出 席 白 


宫 南 草坪 的 活动 时 ， 请 牢记 这 一 点 ， 间 防 上 当 。) 
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O 提示 : 如 果 你 搞 不 清楚 为 什么 你 的 邮件 连接 无 法 正常 工作 ， 那 么 可 以 调用 : 
mailSession. setDebug (true); 
并 检查 消息 。 mE, JavaMail API FAQ WAH HAA MER. 
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package mail; 


import java.10.*; 

import java.nio.charset.*; 

import java.nio.file.*; 

import java.util.*; 

import javax.mail.*; 

import javax.mail.internet.*; 

import javax.mail.internet.MimeMessage.RecipientType; 


/** 


* This program shows how to use JavaMail to send mail messages. 
* @author Cay Horstmann 
* @version 1.00 2012-06-04 


* 


public class MailTest 


{ 


public static void main(String[] args) throws MessagingException, IOException 


{ 


Properties props = new Properties(); 
try (InputStream in = Files.newInputStream(Paths.get("mail", "mail.properties'))) 


props. load(in) ; 
List<String> lines = Files.readAllLines(Paths.get(args[0]), Charset. forName("UTF-8")) ; 


String from = lines.get(0); 
String to = lines.get(1); 
String subject = lines.get(2); 


StringBuilder builder = new StringBuilder(); 
for (int 1 = 3; 1 < lines.size(); i++) 
{ 

builder. append(lines.get(i)); 

builder. append("\n") ; 


Console console = System.console(); 
String password = new String(console.readPassword("Password: ")); 


Session mailSession = Session.getDefaultInstance(props) ; 

// mailSession.setDebug(true) ; 

MimeMessage message = new MimeMessage(mail Session) ; 
message.setFrom(new InternetAddress(from)) ; 

message. addRecipient(RecipientType.T0, new InternetAddress(to)) ; 
message. setSubject (subject) ; 





47 message. setText (builder. toString()); 

48 Transport tr = mailSession.getTransport() ; 

49 try 

50 { 

51 tr.connect(null, password) ; 

52 tr.sendMessage(message, message.getAllRecipients()); 


} 
54 finally 
{ 


56 tr.close(); 


在 本 章 中 ， 你 已 经 看 到 了 如 何 用 Java 编写 网 络 客 户 端 和 服务 器 ， 以 及 如 何 从 Web 服务 
船上 获取 数据 。 下 一 章 将 讨论 数据 库 连 接 ， 你 将 会 学 习 如 何 通过 使 用 JDBC API 来 实现 用 
Java 操作 关系 型 数据 库 。 





第 5 章 数据 库 编 程 


A JDBC 的 设计 A 行 集 

A 结构 化 查询 语言 A 元 数据 

A JDBC 配置 A 事务 

A 使 用 JDBC 语句 A 高 级 SQL 类 型 

A 执行 查询 操作 A Web 和 企业 应 用 中 的 连接 管理 
A 可 滚动 和 可 更 新 的 结果 集 


1996 Æ, Sun 公司 发 布 了 第 1 版 的 Java 数据 库 连 接 (JDBC) API， 使 编程 人 员 可 以 通过 
这 个 API 接口 连接 到 数据 库 ， 并 使 用 结构 化 查询 语言 ( 即 SQL) 完成 对 数据 库 的 查找 与 更 新 。 
(SQL 通常 发 音 为 “ sequel”， 它 是 数据 库 访问 的 业界 标准 。) JDBC 自 此 成 为 Java 类 库 中 最 常 
使 用 的 API 之 一 。 

JDBC 的 版 本 已 更 新 过 数 次 。 作 为 Java SE 1.2 的 一 部 分 ，1998 年 发 布 『 JDBC 第 2 版 。 
JDBC 3 CARRIES T Java SE 1.4 和 5.0 中 ， 而 在 本 书 出 版 之 际 ， 最 新 版 的 JDBC 4.2 也 被 
囊括 到 了 Java SE 8 中 。 

在 本 章 中 ， 我 们 将 阐述 JDBC 幕后 的 关键 思想 ， 并 将 介绍 (或 者 是 复习 ) 一 下 SQL 
( Structured Query Language， 结 构 化 查询 语言 )， 它 是 关系 数据 库 的 业界 标准 。 我 们 还 将 提供 
足够 的 细节 ， 使 你 可 以 将 JDBC 融入 到 常见 的 编程 场景 中 。 


注意 : 根据 Oracle 的 声明 ,JDBC 是 一 个 注册 了 商标 的 术语 ， 而 并 非 Java Database 
Connectivity 的 首 字母 缩写 。 对 它 的 命名 体现 了 对 ODBC 的 致敬 ， 后 者 是 微软 开创 的 标 
准 数据 库 API， 并 因此 而 并 入 了 SQL 标准 中 。 


5.1 JDBC 的 设计 


从 一 开始 ，Java 技术 开发 人 员 就 意识 到 了 Java 在 数据 库 应 用 方面 的 巨大 潜力 。 从 1995 
年 开始 ， 他 们 就 致力 于 扩展 Java 标准 类 库 ， 使 之 可 以 运用 SQL 访问 数据 库 。 他 们 最 初 希望 
通过 扩展 Java， 就 可 以 让 人 们 “ 纯 ” 用 Java 语言 与 任何 数据 库 进行 通信 。 但 是 ， 他 们 很 快 发 
现 这 是 一 项 无 法 完成 的 任务 : 因为 业界 存在 许多 不 同 的 数据 库 ， 且 它们 所 使 用 的 协议 也 各 不 
相同 。 尽 管 很 多 数据 库 供应 商都 表示 支持 Java 提供 一 套数 据 库 访问 的 标准 网 络 协议 ， 但 是 每 
一 家 企业 都 希望 Java 能 采用 上 自己 的 网 络 协议 。 

所 有 的 数据 库 供应 商 和 工具 开发 商都 认为 ， 如 果 Java 能 够 为 SQL 访问 提供 一 套 
“ot” Java API， 同 时 提供 一 个 驱动 管理 器 ， 以 允许 第 三 方 驱动 程序 可 以 连接 到 特定 的 数据 库 ， 
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那 它 就 会 显得 非常 有 用 。 这 样 ， 数 据 库 供应 商 就 可 以 提供 自己 的 驱动 程序 ， 将 其 插入 到 驱动 
管理 器 中 。 这 将 成 为 一 种 向 驱动 管理 需 注 册 第 三 方 驱动 程序 的 简单 机 制 。 

这 种 接口 组 织 方式 遵循 了 微软 公司 非常 成 功 的 ODBC 模式 ，ODBC 为 C 语言 访问 数据 库 
提供 了 一 套 编程 接口 。JDBC 和 ODBC 都 基于 同一 个 思想 : 根据 API 编写 的 程序 都 可 以 与 驱 
动 管理 器 进行 通信 ， 而 驱动 管理 器 则 通过 驱动 程序 与 实际 的 数据 库 进 行 通信 。 

所 有 这 些 都 意味 着 JDBC API 是 大 部 分 程序 员 不 得 不 使 用 的 接口 。 


5.1.1 JDBC 驱动 程序 类 型 


JDBC 规范 将 驱动 程序 归结 为 以 下 几 类 : 

of 1 类 驱动 程序 将 JDBC 翻译 成 ODBC， 然 后 使 用 一 个 ODBC 驱动 程序 与 数据 库 进 行 
通信 。 较 早 版 本 的 Java 包含 了 一 个 这 样 的 驱动 程序 : JDBC/ODBC 桥 ， 不 过 在 使 用 这 
个 桥接 器 之 前 需要 对 ODBC 进行 相应 的 部 署 和 正确 的 设置 。 在 JDBC 面世 之 初 ， 桥 接 
器 可 以 方便 地 用 于 测试 ， 却 不 太 适 用 于 产品 的 开发 。Java 8 已 经 不 再 提供 JDBC/ODBC 
桥 了 。 

o 第 2 类 了 驱动 程序 是 由 部 分 Java 程序 和 部 分 本 地 代码 组 成 的 ， 用 于 与 数据 库 的 客户 端 
API 进行 通信 。 在 使 用 这 种 驱动 程序 之 前 ， 客 户 端 不 仅 需要 安装 Java 类 库 ， 还 需要 安 
装 一 些 与 平台 相关 的 代码 。 

e 第 3 类 驱动 程序 是 纯 Java 客户 端 类 库 ， 它 使 用 一 种 与 具体 数据 库 无 关 的 协议 将 数据 库 
请 求 发 送 给 服务 器 构件 ， 然 后 该 构件 再 将 数据 库 请 求 翻译 成 数据 库 相 关 的 协议 。 这 简 
化 了 部 署 ， 因 为 平台 相关 的 代码 只 位 于 服务 硕 端 。 

o 第 4 类 驱动 程序 是 纯 Java 类 库 ， 它 将 JDBC 请 求 直接 翻译 成 数据 库 相 关 的 协议 。 


注意 : JDBC 规范 可 以 在 http://download.oracle.com/otndocs/jcp/jdbc-4 2-mrel2-spec/ 处 获得 。 


大 部 分 数据 库 供应 商都 为 他 们 的 产品 提供 第 3 类 或 第 4 类 驱动 程序 。 与 数据 库 供应 商 提 
供 的 驱动 程序 相 比 ， 许 多 第 三 方 公司 专门 开发 了 很 多 更 符合 标准 的 产品 ， 它 们 文 持 更 多 的 平 
台 、 运 行 性 能 也 更 佳 ， 某 些 情况 下 甚至 具有 更 高 的 可 靠 性 。 

总 之 ，JDBC 最 终 是 为 了 实现 以 下 目标 : 

o 通过 使 用 标准 的 SQL 语句 ， 甚 至 是 专门 的 SQL 扩展 ， 程序 员 就 可 以 利用 Java 语言 

发 访问 数据 库 的 应 用 ， 同 时 还 依旧 遵守 Java 语言 的 相关 约定 。 
o 数据 库 供 应 商 和 数据 库 工具 开发 商 可 以 提供 底层 的 驱动 程序 。 因 此 ， 他 们 可 以 优化 各 
自 数 据 库 产品 的 驱动 程序 。 
注意 : 也 许 你 会 问 为 什么 Java 没 有 采用 ODBC 模 型 下面 就 是 在 1996 年 举行 的 

JavaOne 研讨 会 上 给 出 的 说 法 : 

e ODBC 很 难 学 会 。 

e ODBC 中 有 几 个 命令 需要 配置 很 多 复杂 的 选项 ， 而 在 Java 编程 语言 中 所 采用 的 风格 是 

要 让 方法 简单 而 直观 ， 但 数量 巨大 。 


e ODBC 依赖 于 void* 指针 和 其 他 C 语言 特性 ， 而 这 些 特性 并 不 适用 于 Java 编程 语言 。 
o 与 纯 Java 的 解决 方案 相 比 ， 基 于 ODBC 的 解决 方案 天 生 就 缺乏 安全 性 ， 且 难于 部 署 。 


5.1.2 JDBC 的 典型 用 法 


在 传统 的 客户 端 / 服 务 器 模型 中 ， 通 常 是 在 服务 器 端 部 署 数据 库 ， 而 在 客户 端 安装 富 
GUI 程序 (参见 图 5-1 )。 在 此 模型 中 ，JDBC 驱动 程序 应 该 部 署 在 客户 端 。 





图 5-1 传统 的 客户 端 /服务 器 应 用 


但 是 ， 如 今 三 层 模型 更 加 和 常见。 在 三 层 应 用 模型 中 ， 客 户 端 不 直接 调用 数据 库 ， 而 是 调 
用 服务 货 上 的 中 间 件 层 ， 由 中 间 件 层 完成 数据 库 查 询 操作 。 这 种 三 层 模型 有 以 下 优点 : 它 将 
TRAT UPR Phin) 从 业务 逻辑 PP) 和 原始 数据 (位 于 数据 库 ) 中 分 离 出 来 。 
Alt, Beal AMAT AS Pig, A Java 桌面 应 用 、 浏 览 右 或 者 移动 App， 来 访问 相同 的 数 
据 和 相同 的 业务 规则 。 

客户 端 和 中 间 层 之 间 的 通信 在 典型 情况 下 是 通过 HTTP 来 实现 的 。JDBC 管理 着 中 间 层 
和 后 台数 据 库 之 间 的 通信 ， 图 5-2 展示 了 这 种 通信 模型 的 基本 架构 。 
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图 5-2 ”三 层 结构 的 应 用 









5.2 ”结构 化 查询 语言 


SQL 是 对 所 有 现代 关系 型 数据 库 都 至 关 重 要 的 命令 行 语言 ，JDBC 则 使 得 我 们 可 以 通过 
SQL 与 数据 库 进 行 通信 。 桌 面 数据 库 通 常 都 有 一 个 图 形 用 户 界面 ; 通过 这 种 界面 ， 用 户 可 以 
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直接 操作 数据 。 但 是 ， 基 于 服务 器 的 数据 库 只 能 使 用 SQL 进行 访问 。 

我 们 可 以 将 JDBC 包 看 作 是 一 个 用 于 将 SQL 语句 传递 给 数据 库 的 应 用 编程 接口 (API)。 
在 本 节 中 ， 我 们 将 简单 介绍 一 下 SQL。 如 果 之 前 没有 接触 过 SQL， 你 会 发 现 这 些 介绍 是 远 远 
不 够 的 ， 你 可 以 参阅 关于 SQL 的 其 他 著作 。 我 们 推荐 Alan Beaulieu 所 著 的 《Learning SQL ) 
( 2009 年 由 OReilly 出 版 社 出 版 )， 或 者 还 可 以 参考 在 线 图 书 《Learn SQL The Hard Way》， 该 
书 可 在 http://sql.learncodethehardway.org 处 获得 。 

可 以 将 数据 库 想 象 成 一 组 由 行 和 列 构成 的 具名 表 ， 其 中 每 一 列 都 有 列 名 〈column name), 
而 每 一 行 则 包含 了 一 个 相关 的 数据 集 。 

作为 本 书 的 数据 库 实例 ， 我 们 将 使 用 一 个 数据 库 表 集 来 描述 一 组 经 典 的 计算 机 著作 (请 
参见 表 5-1 ~ 表 5-4 )。 

表 5-1 Authors # 


Author_ID Name Fname 
ALEX Alexander Christopher 
BROO Brooks Frederick P. 


% 5-2 Books 表 


Title ISBN Publisher_ID Price 
A Guide to the SQL Standard 0-201-96426-0 0201 47.95 
A Pattern Language: Towns, Buildings, Construction 0-19-501919-9 019 65.00 


表 5-3 BooksAuthors 表 


ISBN Author_ID Seq_No 
0-201-96426-0 DATE ] 
0-201-96426-0 DARW 2 
0-19-501919-9 ALEX l 


表 5-4 Publishers 3 


Publisher_ID Name URL 
0201 Addison-Wesley www.aw-bc.com 
0407 John Wiley & Sons www.wiley.com 


图 5-3 显示 的 是 一 个 Books 表 的 视图 ， 而 图 5-4 显示 了 对 Books 表 和 Publishers 表 执 
行 连接 操作 后 的 结果 。Books 表 和 Publishers 表 都 包含 了 一 个 表示 出 版 社 的 ID 字段 。 当 我 
们 利用 出 版 社 编号 对 这 两 个 表 进 行 连接 操作 时 ， 我们 就 得 到 了 由 连接 后 的 表格 的 值 所 组 成 的 查 
询 结 果 。 结 果 中 的 每 一 行 都 包含 了 图 书 的 信息 、 出 版 社 名 称 及 其 Web 页 的 URL 地 址 。 注 意 ， 
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有 的 出 版 社 名 称 和 URL 地 址 会 重复 出 现在 数 行 中 ， 因 为 这 些 行 部 对 应 于 同一 个 出 版 社 。 


$ CORE sion Hooks 


+ ec rograrnnina Cinania , 


à Pattern Language: Towns, D ai Construction 
d Computation 


[|__]introduction to Automata Theory. Languages, an 


he C++ Programming Language 
e Mythical Man-Month 
Computer Graphics: Principles and Practice 
he Art of Computer Programming vol. 1 
he Art of Computer Programming vol. 2 


| [Cuckoo's Egg 
the UNIX Haters Handbook — 


‘O-13-02060 1-6 
0. 13-110362-8 


10-19-$01919-9 019 


0-201-44124-1 02 
0-201-63361-2 i 
9- 201- 70073-5 j 


0-201-83595-9 
0-201-84840-6 
0:201- 89683-4 


0-201-89664-2 02 

0-201-09665-0 | 

`- 10-201-96426-0 0201 

0-262-03293-7 
'0-471-11709-9 | 
0-596-00048-0 


0-596-00108-8 
0-679-60261-5 
0-684-63130-9 


0-7434-1146-3 07434 


f 1- 56864-203-1 a71 
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图 5-4 ”对 两 个 表 进 行 连接 操作 
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对 表格 进行 连接 操作 的 好 处 是 能 够 避免 在 数据 库 表 中 出 现 不 必要 的 重复 数据 。 例 如 ， 有 
一 种 比较 简陋 的 数据 库 设计 是 在 Books 表 中 设置 出 版 社 名 称 和 URL 地 址 字段 。 但 是 这 样 一 
来 ， 数 据 库 本 身 ， 而 非 查询 结果 ， 将 出 现 许多 重复 数据 。 如 果 出 版 社 的 Web 地 址 发 生 了 改 
变 ， 就 需要 更 新 所 有 的 重复 数据 。 显 然 ， 这 在 一 定 程 度 上 很 容易 导致 错误 。 在 关系 模型 中 ， 
我 们 将 数据 分 布 到 多 个 表 中 ， 使 得 所 有 信息 都 不 会 出 现 不 必要 的 重复 。 例 如 ， 每 个 出 版 社 的 
URL 地 址 只 在 出 版 社 表 中 出 现 一 次 。 如 果 需 要 将 此 信息 与 其 他 信息 组 合 ， 我 们 只 需 对 表 进 行 
连接 操作 。 

在 上 述 两 幅 图 中 ， 可 以 看 到 一 个 用 于 查看 和 链接 表 的 图 形 工具 。 许 多 数据 库 提供 商 部 具 
有 相应 的 工具 ， 通 过 连接 列 名 和 在 表单 中 填 人 信息 ， 让 用 户 能 够 以 某 种 简单 的 形式 来 表示 其 
各 种 查询 。 这 种 工具 通常 称 为 实例 查询 (Query by Example, QBE) 工具 。 而 使 用 SQL 的 查 
询 则 是 利用 SQL 语法 以 文本 方式 编写 的 。 例 如 ， 


SELECT Books ,Title，Books,Pub1isher Id, Books,.Price, Publishers,.Name, Publishers.URL 
FROM Books, Publishers 
WHERE Books.Publisher Id = Publishers,.Publisher Id 


在 本 节 的 余下 部 分 中 ， 我 们 将 介绍 如 何 编写 这 样 的 查询 语句 。 如 果 你 已 经 熟悉 SQL T, 
就 可 以 跳 过 这 部 分 内 容 。 

按照 惯例 ，SQL 关键 字 全 部 使 用 大 写字 母 。 当 然 ， 也 可 以 不 这 样 做 。 

SELECT 语句 相当 灵活 。 仅 使 用 下 面 这 个 查询 语句 ， 就 可 以 查 出 Books 表 中 的 所 有 记录 : 

SELECT * FROM Books 

在 每 一 个 SQL 的 SELECT 语句 中 ，FROM 子 句 都 是 必 不 可 少 的 。FROM 子 句 用 于 告知 数据 
库 应 该 在 哪个 表 上 查询 数据 。 

我 们 还 可 以 选择 所 需要 的 列 : 


SELECT ISBN, Price, Title 
FROM Books 


并 且 还 可 以 在 查询 语句 中 使 用 WHERE 子 句 来 限定 所 要 选择 的 行 : 


SELECT ISBN, Price, Title 
FROM Books 
WHERE Price <= 29.95 


请 小 心 使 用 “相等 ”这 个 比较 操作 。 与 Java 编程 语言 不 同 ，SQL 使 用 = fl > 而 非 一 
和 |= 来 进行 相等 比较 。 
注意 : 有 些 数据 库 供 应 商 的 产品 支持 在 进行 不 等 于 比较 时 使 用 !=。 这 不 符合 标准 SQL 的 

语法 ， 所 以 我 们 建议 不 要 使 用 这 种 方法 。 

WHERE 子 句 也 可 以 使 用 LIKE 操作 符 来 实现 模式 匹配 。 不 过 ， 这 里 的 通配符 并 不 是 通常 
使 用 的 * 和 ?， 而 是 用 % 表 示 0 或 多 个 字符 ， 用 下 划 线 表示 单个 字符 。 例 如 ， 


SELECT ISBN, Price, Title 
FROM Books 
WHERE Title NOT LIKE '%n_x%' 
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这 条 语句 排除 了 所 有 书 名 中 包含 UNIX 或 者 Linux 的 图 书 。 
请 注意 ， 字 符 串 都 是 用 单 引 号 括 起 来 的 ， 而 非 双 引号 。 字 符 串 中 的 单 引号 则 需要 用 一 对 
单 引号 代替 。 例 如 ， 


SELECT Title 
FROM Books 
WHERE Title LIKE '%''%' 


上 述 语句 会 返回 所 有 包含 单 引号 的 书 名 。 

你 也 可 以 从 多 个 表 中 选取 数据 : 

SELECT * FROM Books, Publishers 

如 果 没 有 WHERE 子 句 ， 上 述 查 询 语句 就 意义 不 大 了 ， 它 只 是 罗列 了 两 个 表 中 所 有 记录 的 
组 合 。 在 我 们 这 个 例子 中 ，Books KA 20 行 记 录 ，Pub1ishers 表 有 8 行 记录 ,合并 的 结果 
将 产生 20 x 8 条 记录 ， 其 中 不 乏 大 量 重复 数据 。 实 际 上 我 们 需要 对 查询 结果 进行 限制 ， 只 对 
那些 图 书 与 出 版 社 相 匹配 的 数据 感 兴趣 。 


SELECT * FROM Books, Publishers 
WHERE Books.Publisher_Id = Publishers.Publisher Id 


这 条 语句 的 查询 结果 共有 20 行 记录 ， 每 一 条 记录 对 应 于 一 本 书 ， 因 为 每 本 书 都 在 
Publishers 表 中 只 对 应 一 个 出 版 社 。 

每 当 查 询 语句 涉及 多 个 表 时 ， 相 同 的 列 名 可 能 会 出 现在 两 个 不 同 的 地 方 。 在 我 们 的 例子 
中 也 存在 这 种 情况 ，Books 表 和 Publishers 表 都 拥有 一 个 列 名 为 Pub1isherId 的 列 。 当 
出 现 皮 义 时 ， 可 以 在 每 个 列 名 前 添加 它 所 在 表 的 表 名 作为 前 级 ， 比 如 Books/Publishers., 

也 可 以 使 用 SQL 来 改变 数据 库 中 的 数据 。 例 如 ， 假 设 现在 要 将 所 有 书 名 中 包含 “ C++” 
的 图 书 降 价 5 美元 ， 可 以 执行 以 下 语句 : 


UPDATE Books 
SET Price = Price - 5.00 
WHERE Title LIKE '%C++%' 


类 似 地 ， 要 删除 所 有 的 C++ 图 书 ， 可 以 使 用 下 面 的 DELETE 查询 : 


DELETE FROM Books 
WHERE Title LIKE '%C++%' 


此 外 ，SQL 中 还 有 许多 内 置 函数 ， 用 于 对 某 一 列 计算 平均 值 、 查 找 最 大 值 和 最 小 值 以 及 
其 他 许多 功能 。 在 此 我 们 就 不 讨论 了 。 
通常 ， 可 以 使 用 INSERT 语句 向 表 中 插入 值 : 


INSERT INTO Books 
VALUES ("A Guide to the SQL Standard', '0-201-96426-0', '0201', 47.95) 


我 们 必须 为 每 一 条 插入 到 表 中 的 记录 使 用 一 次 INSERT 语句 。 

当然 ， 在 查询 、 修 改 和 插入 数据 之 前 ， 必 须要 有 存储 数据 的 位 置 。 可 以 使 用 CREATE 
TABLE 语句 创建 一 个 新 表 ， 还 可 以 为 每 一 列 指 定 列 名 和 数据 类 型 。 

CREATE TABLE Books 
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Title CHAR(60), 
ISBN CHAR(13), 
Publisher_Id CHAR(6), 
Price DECIMAL (10,2) 

) 


表 5-5 给 出 了 最 常见 的 SQL 数据 类 型 。 
表 5-5 SQL 数据 类 型 





数据 类 型 说 AB 
INTEGER 或 INT 通常 为 32 位 的 整数 
SMALLINT 通常 为 16 位 的 整数 
NUMERIC(m,n), DECIMAL(m,n) or DEC(m,n) m 位 长 的 定点 十 进 制 数 ， 其 中 小 数 点 后 为 n 位 
FLOAT(n) 运算 精度 为 n 位 二 进 制 数 的 浮 点 数 
REAL 通常 为 32 位 浮 点 数 
DOUBLE 通常 为 64 位 浮 点 数 
CHARACTER(n) or CHAR(n) 固定 长 度 为 n 的 字符 串 
VARCHAR(n) 最 大 长 度 为 n 的 可 变 长 字符 串 
BOOLEAN 布尔 值 
DATE 日 历 日 期 (与 具体 的 实现 相关 ) 
TIME 当前 时 间 (与 具体 的 实现 相关 ) 
TIMESTAMP 当前 日 期 和 时 间 (与 具体 的 实现 相关 ) 
BLOB 二 进 制 大 对 象 
CLOB 字符 大 对 象 





在 本 书 中 ， 我们 不 再 介绍 更 多 的 子 句 ， 比 如 可 以 应 用 于 CREATE TABLE 语句 的 主键 子 名 
和 约束 子 句 。 
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当然 ， 你 需要 有 一 个 可 获得 其 JDBC 驱动 程序 的 数据 库 程 序 。 目 前 这 方面 有 许多 出 色 的 
程序 可 供 选 择 ， 比 如 IBM DB2、Microsoft SQL Server, MySQL, Oracle 和 PostgreSQL. 

为 了 练习 本 部 分 内 容 ， 你 还 需要 创建 一 个 数据 库 ， 我 们 假定 你 将 这 个 数据 库 命 名 为 
COREJAVA。 你 要 自己 创建 ， 或 者 让 数据 库 管 理 员 创建 这 个 数据 库 ， 并 使 之 拥有 适当 权限 ， 
因为 你 需要 拥有 对 这 个 数据 库 进 行 创建 、 更 新 和 删除 表 的 权限 。 

如 果 你 以 前 从 未 安装 过 采用 客户 端 / 服 务 器 模式 的 数据 库 ， 那 么 就 会 发 现 配置 这 样 一 个 
数据 库 会 稍 显 复杂 并 且 难 于 诊断 故障 的 原因 。 如 果 安 装 的 数据 库 无 法 正常 运行 ， 那 么 最 好 请 
专家 来 帮 性 :。 

如 果 第 一 次 接触 数据 库 ， 我 们 建议 使 用 Apache Derby， 它 可 以 从 http://db.apache.org/ 
derby 处 下 载 到 ， 在 某 些 IDK 版 本 中 也 包含 了 它 。 
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E] 注意 : 包含 在 JDK 中 的 Apache Derby 版 本 官方 名 称 为 JavaDB， 我 们 认为 这 个 名 字 没 什 
么 特别 用 处 ， 因 此 我 们 在 本 章 中 称 其 为 Derby。 


在 编写 第 一 个 数据 库 程序 之 前 ， 你 需要 收集 大 量 的 信息 和 文件 ， 下 面 将 讨论 这 些 内容 。 


5.3.1 数据 库 URL 
在 连接 数据 库 时 ， 我 们 必须 使 用 各 种 与 数据 库 类 型 相关 的 参数 ， 例 如 主机 名 、 端 口号 和 
数据 库 名 。 


JDBC 使 用 了 一 种 与 普通 URL 相 类 似 的 语法 来 描述 数据 源 。 下 面 是 这 种 语法 的 两 个 实例 : 


jdbc:derby://localhost:1527/COREJAVA: create=true 
jdbc: postgresql :COREJAVA 


上 述 JDBC URL 指定 了 名 为 COREJAVA 的 一 个 Derby 数据 库 和 一 个 PostgreSQL 数据 库 。 
JDBC URL 的 一 般 语 法 为 : 

jdbc: subprotocol: other stuff 

HF, subprotocol 用 于 选择 连接 到 数据 库 的 具体 驱动 程序 。 

other stuff 参数 的 格式 随 所 使 用 的 subprotocol 不 同 而 不 同 。 如 果 要 了 解 具体 格式 ， 你 需 
要 查阅 数据 库 供 应 商 提供 的 相关 文档 。 


5.3.2 ”驱动 程序 JAR 文件 


你 需要 获得 包含 了 你 所 使 用 的 数据 库 的 驱动 程序 的 JAR 文件 。 如 果 你 使 用 的 是 Derby， 
那么 就 需要 derbyc1ient .jar ; 如 果 你 使 用 的 是 其 他 的 数据 库 ， 那 么 就 需要 去 寻找 恰当 的 
驱动 程序 。 例 如 ，PostgreSQL 的 驱动 程序 可 以 在 http:Wjdbc.postgresql.org 处 找到 。 

在 运行 访问 数据 库 的 程序 时 ， 需 要 将 驱动 程序 的 JAR 文件 包括 到 类 路 径 中 (编译 时 并 不 
需要 这 个 JAR 文件 )。 

在 从 命令 行 启动 程序 时 ， 只 需要 使 用 下 面 的 命令 : 

java -classpath driverPath:. ProgramName l 

在 Windows 上 ， 可 以 使 用 分 号 将 当前 路 径 (Bh .字符 表示 的 路 径 ) 与 驱动 程序 JAR 文 
件 分 隔 开 。 


5.3.3 ”局 动 数 据 库 


数据 库 服 务 器 在 连接 之 前 需要 先 启动 ， 启 动 的 细节 取决 于 所 使 用 的 数据 库 。 

在 使 用 Derby 数据 库 时 ， 需 要 遵循 下 面 的 步 又 . 

1 ) 打开 命令 shell， 并 转 到 将 来 存放 数据 库 文件 的 目录 中 。 

2) 定位 derbyrun.jar。 对 于 某 些 IDK 版 本 ， 它 包含 在 jdk/db/1ib 目录 中 ， 如 果 没 
有 包含 ， 那 就 安装 Apache Derby， 并 定位 安装 目录 的 JAR 文件 。 我 们 用 derby 来 表示 包含 
lib/derbyrun. jar 的 目录 。 
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3) 运行 下 面 的 命令 : 

java -jar derby/lib/derbyrun.jar server start 

4) 仔细 检查 数据 库 是 否 正确 工作 了 。 然 后 创建 一 个 名 为 1j.properties 并 包含 下 面 各 
行 的 文件 : 


ij ,driver=org,apache,derby,jdbc,ClientDriver 
ij.protocol=jdbc:derby://localhost:1527/ 
jj].database=COREJAVA; create=true 


在 另 一 个 命令 shell 中 ， 通 过 执行 下 面 的 命令 来 运行 Derby 的 交互 式 脚本 执行 工具 ( 称 为 1j): 
java -jar derby/lib/derbyrun.jar ij -p ij.properties 


现在 ， 可 以 发 布 像 下 面 这 样 的 SQL 命令 了 : 


CREATE TABLE Greetings (Message CHAR(20)) ; 
INSERT INTO Greetings VALUES (‘Hello, World!'); 
SELECT * FROM Greetings; 

DROP TABLE Greetings; 


注意 ， 每 条 命令 都 需要 以 分 号 结尾 ， 要 退出 编辑 器 ， 可 以 键入 
EXIT; 
5) 在 使 用 完 数据 库 之 后 ， 可 以 用 下 面 的 命令 关闭 服务 天 : 


java -jar derby/lib/derbyrun.jar server shutdown 


AUR FARE E,W RY, AT AUTA A ER ae, LAK 
如 何 连接 到 数据 库 和 发 布 SQL 命令 。 


5.3.4 注册 驱动 器 类 


许多 JDBC 的 JAR 文件 (例如 包含 在 Java SE 8 中 的 Derby 驱动 程序 ) 会 自动 注册 驱动 
器 类 ， 在 这 种 情况 下 ， 可 以 跳 过 本 节 所 描述 的 手动 注册 步 又。 包含 META-INF/services/ 
java.sq1.Driver 文件 的 JAR 文件 可 以 自动 注册 驱动 器 类 ， 解 压缩 驱动 程序 JAR 文件 就 可 
以 检查 其 是 否 包含 该 文件 。 


注意 这 种 注册 机 制 使 用 的 是 JAR 规 范 中 几乎 不 为 人 知 的 特性 ， 请 参见 http://docs. 
oracle.com/ javase/8/docs/technotes/guides/jar/jar.html#Service%20Provider . 自动 注 
册 对 于 遵循 JDBC4 的 驱动 程序 是 必须 具备 的 特性 。 
如 果 驱 动 程序 JAR 文件 不 支持 自动 注册 ， 那 就 需要 找 出 数据 库 提供 商 使 用 的 JDBC 驱动 
器 类 的 名 字 。 典 型 的 驱动 大 名 字 如 下 : 


org.apache.derby.jdbc.ClientDriver 
org. postgresql .Driver 


通过 使 用 DriverManager， 可 以 用 两 种 方式 来 注册 驱动 器 。 一 种 方式 是 在 Java 程序 中 
加 载 驱动 器 类 ， 例如: 


242 Java ZSRR AKI SAH 


Class. forName("org.postgresq].Driver"); // force loading of driver class 
这 条 语句 将 使 得 驱动 器 类 被 加 载 ， 由 此 将 执行 可 以 注册 驱动 器 的 静态 初始 化 器 。 
万 一 种 方式 是 设置 jdbc .drivers 属性 。 可 以 用 命令 行 参数 来 指定 这 个 属性 ， 例 如 : 
java -Djdbc.drivers=org.postgresq] Driver ProgramName 
或 者 在 应 用 中 用 下 面 这 样 的 调用 来 设置 系统 属性 
System. setProperty("jdbc.drivers", "org.postgresql.Driver"); 
在 这 种 方式 中 可 以 提供 多 个 驱动 器 ， 用 冒号 将 它们 分 隔 开 ， 例 如 


org.postgresql ,Driver:org,apache,derby,jdbc,ClientDriver 


5.3.5 连接 到 数据 库 


在 Java 程序 中 ， 我 们 可 以 在 代码 中 打开 一 个 数据 库 连 接 ， 例 如 : 


String url = "jdbc:postgresq] :COREJAVA": 

String username = "dbuser": 

String password = "secret"; 

Connection conn = DriverManager.getConnection(url, username, password) ; 


OK oh et BE aia Dh a EL SK NRA, MERA — 7 HE E HE URL 中 指定 的 
子 协议 的 驱动 程序 。 

getConnection 方法 返回 一 个 Connection 对 象 。 在 下 一 节 中 ， 我 们 将 详细 介绍 如 何 
使 用 Connection 对 象 来 执行 SQL 语句 。 

要 连接 到 数据 库 ， 我 们 还 需要 知道 数据 库 的 名 字 和 密码 。 


注意 : 在 默认 情况 下 ，Derby 允许 我 们 使 用 任何 用 户 名 进行 连接 ， 并 且 不 检查 密码 。 它 
会 为 每 个 用 户 生成 一 个 单独 的 表 集 合 ， 而 默认 的 用 户 名 是 app。 
程序 清单 $5-1 中 的 测试 程序 将 所 有 这 些 步骤 放 到 了 一 起 : 它 从 名 为 database. 
properties 的 文件 中 加 载 连接 参数 ， 并 连接 到 数据 库 。 示 例 代 码 中 提供 的 database. 
properties 文件 包含 的 是 关于 Derby 数据 库 的 连接 信息 ， 如 果 使 用 其 他 的 数据 库 ， 则 需要 将 
与 数据 库 相 关 的 连接 信息 放 到 这 个 文件 中 。 下 面 是 一 个 用 于 连接 到 PostgreSQL 数据 库 的 示例 : 


jdbc.drivers=org. postgresql .Driver 
jdbc.url=jdbc:postgresq] :COREJAVA 
jdbc.username=dbuser 
jdbc. password=secret 


在 连接 到 数据 库 之 后 ， 这 个 测试 程序 执行 了 下 面 的 SQL 语句 : 


CREATE TABLE Greetings (Message CHAR(20)) 
INSERT INTO Greetings VALUES ('Hello, World!') 
SELECT * FROM Greetings 


SELECT 的 结果 将 被 打印 出 来 ， 你 应 该 可 以 看 到 如 下 的 输出 : 
Hello, World! 
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然后 ， 通 过 执行 下 面 的 语句 移 除 了 这 张 表 : 

DROP TABLE Greetings 

要 运行 这 个 测试 程序 ， 需 要 启动 数据 库 ， 并 像 下 面 这 样 启 动 这 个 程序 : 
java -classpath .:driverJAR test.TestDB 


(Windows 用 户 需 要 注意 ， 用 ; RE: 来 分 隔 路 径 元 素 。) 


G 提示 : 调试 与 JDBC 相关 的 问题 时 ， 有 种 方法 是 启用 JDBC 的 跟踪 特性 。 调 用 
DriverManager.setLogWriter 方 法 可 以 将 跟踪 信息 发 送 给 PrintWriter， 而 
PrintWriter 将 输出 JDBC 活动 的 详细 列表 。 大 多 数 JDBC 驱动 程序 的 实现 都 提供 了 用 
于 跟踪 的 附加 特性 例如， 在 使 用 Derby 时 ， 可 以 在 JDBC 的 URL 中 添加 traceFile 
选项 ， 如 jdbc:derby://1ocalhost:1527/ COREJAVA;create=true;traceFile= 


trace.out, 






package test; 


import java.nio.file.*; 
import java.sql.*; 
import java.10.*; 
import java.util.*; 


/** 
* This program tests that the database and the JDBC driver are correctly configured. 
10 * @version 1.02 2012-06-05 
11 * @author Cay Horstmann 
2 */ 
13 public class TestDB 


wo ron DTD en A ww N e 


15 public static void main(String args[]) throws IOException 


16 { 

17 try 

18 { 

19 runtest(); 

20 } 

21 catch (SQLException ex) 
22 { 

23 for (Throwable t : ex) 
24 t.printStackTrace() ; 
25 } 

26 } 

27 

8 /** 


29 * Runs a test by creating a table, adding a value, showing the table contents, and removing 
30 * the table. 


31 */ 
32 public static void runTest() throws SQLException, IOException 
33 { 


244 Java ZSRR Al ZRH 


34 try (Connection conn = getConnection(); 

35 Statement stat = conn.createStatement ()) 

36 { 

37 Stat.executeUpdate("CREATE TABLE Greetings (Message CHAR(20))"); 

38 Stat.executeUpdate ("INSERT INTO Greetings VALUES ('Hello, World!')"); 
39 

40 try (ResultSet result = stat.executeQuery("SELECT * FROM Greetings")) 
41 

42 if (result.next()) 

43 System. out.print]n(result.getString(1)); 

44 } 

45 Stat.executeUpdate("DROP TABLE Greetings"); 

46 } 

47 } 

48 

49 /** 

50 * Gets a connection from the properties specified in the file database. properties. 
51 * @return the database connection 

52 */ 

53 public static Connection getConnection() throws SQLException, IOException 
54 { 

55 Properties props = new Properties(); 

56 try (InputStream in = Files.newInputStream(Paths.get("database.properties'))) 
57 { 

58 props. load(in); 

59 

60 String drivers = props.getProperty("jdbc.drivers"); 

61 if (drivers != null) System.setProperty("jdbc.drivers", drivers); 

62 String url = props.getProperty("jdbc.url"); 

63 String username = props.getProperty("jdbc. username") ; 

64 String password = props.getProperty("jdbc. password") ; 

65 

66 return DriverManager.getConnection(url, username, password); 

67 } 

68 } 





e static Connection getConnection(String url, String user, String password) 


建立 一 个 到 指定 数据 库 的 连接 ， 并 返回 一 个 Connection 对 象 。 


5.4 使 用 JDBC 语句 


在 下 面 各 节 中 ， 你 将 会 看 到 如 何 使 用 JDBC Statement 来 执行 SQL 语句 ， 获 得 执行 结 
东 ， 以 及 处 理 错误 。 然 后 ， 我 们 将 向 你 展示 一 个 操作 数据 库 的 简单 示例 。 


5.4.1 执行 SQL 语句 
在 执行 SQL 语句 之 前 ， 首 先 需要 创建 一 个 Statement 对 象 。 要 创建 Statement 对 象 ， 





HSE KEM 245 


需要 使 用 调用 Dri verManager .getConnection 方法 所 获得 的 Connection 对 象 。 
Statement stat = conn.createStatement() ; 


接着 ， 把 要 执行 的 SQL 语句 放 入 字符 串 中 ， 例 如 : 


String command = "UPDATE Books" 
+ " SET Price = Price - 5.00" 
+ " WHERE Title NOT LIKE '%Introduction%'"; 


然后 ， 调 用 Statement 接口 中 的 executeUpdate 方法 : 


stat. executeUpdate (command) ; 

executeUpdate 方法 将 返回 受 SQL 语句 影响 的 行 数 ， 或 者 对 不 返回 行 数 的 语句 返回 0。 
例如 ， 在 先前 的 例子 中 调用 executeUpdate 方法 将 返回 那些 降价 5 美元 的 行 数 。 

executeUpdate 方法 既 可 以 执行 诸如 INSERT、UPDATE 和 DELETE 之 类 的 操作 ， 也 可 
以 执行 诸如 CREATE TABLE 和 DROP TABLE 之 类 的 数据 定义 语句 。 但 是 ， 执 行 SELECT 查询 
时 必须 使 用 executeQuery 方法 。 另 外 还 有 一 个 execute 语句 可 以 执行 任意 的 SQL 语句 ， 
此 方法 通常 只 用 于 由 用 户 提供 的 交互 式 查询 。 

当 我 们 执行 查询 操作 时 ， 通 常 感 兴趣 的 是 查询 结果 。executeQuery 方法 会 返回 一 个 
ResultSet 类 型 的 对 象 ， 可 以 通过 它 来 每 次 一 行 地 迭代 遍历 所 有 查询 结果 。 


ResultSet rs = stat.executeQuery("SELECT * FROM Books"); 


分 析 结果 集 时 通常 可 以 使 用 类 似 如 下 的 循环 语句 代码 : 


while (rs.next()) 


look at a row of the result set 


@ @H: ResultSet 接口 的 选 代 协 议 与 java.util.Iterator# UA AM. HT 
ResultSet 接口 ， 和 迭代 器 初始 化 时 被 设 定 在 第 一 行 之 前 的 位 置 ， 必 须 调用 next 方法 将 
它 移动 到 第 一 行 。 另 外 ， 它 没有 hasNext 方法 ， 我们 需要 不 断 地 调用 next， 直 至 该 方 
法 返回 false。 


结果 集中 行 的 顺序 是 任意 排列 的 。 除 非 使 用 ORDER BY 子 句 指定 行 的 顺序 ， 否 则 不 能 为 
行 序 强 加 任何 意义 。 

查看 每 一 行 时 ， 可 能 希望 知道 其 中 每 一 列 的 内 容 ， 有 许多 访问 盘 ( accessor) 方法 可 以 用 
于 获取 这 些 信息 。 


String isbn = rs.getString(1); 
double price = rs.getDouble("Price"); 


不 同 的 数据 类 型 有 不 同 的 访问 器 ， 比 如 getString 和 getDoub1le。 每 个 访问 需 都 有 两 
种 形式 ， 一 种 接受 数字 型 参数 ， 另 一 种 接受 字符 串 参 数 。 当 使 用 数字 型 参数 时 ， 我 们 指 的 是 
该 数字 所 对 应 的 列 。 例 如 ，rs.getString(1) 返回 的 是 当前 行 中 第 一 列 的 值 。 
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O 警告 : 与 数组 的 索引 不 同 ， 数 据 库 的 列 序号 是 从 1 开始 计算 的 。 


当 使 用 字符 串 参 数 时 ， 指 的 是 结果 集中 以 该 字符 串 为 列 名 的 列 。 例 如 ，rs .getDouble 
("Price") 返回 列 名 为 Price 的 列 所 对 应 的 值 。 使 用 数字 型 参数 效率 更 高 一 些 ， 但 是 使 用 
字符 串 参 数 可 以 使 代码 易于 阅读 和 维护 。 

当 get 方法 的 类 型 和 列 的 数据 类 型 不 一 致 时 ， 每 个 get 方法 都 会 进行 合理 的 类 型 转换 。 
例如 ， 调 用 rs.getString("Price") 时 ， 该 方法 会 将 Price 列 的 浮 点 值 转换 成 字符 串 。 
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e Statement createStatement( ) 


创建 一 个 Statement 对 象 ， 用 以 执行 不 带 参数 的 SQL 查询 和 更 新 。 


e void close() 
立即 关闭 当前 的 连接 ， 并 释放 由 它 所 创建 的 JDBC 资源 。 










e ResultSet executeQuery(String sqiQuery) 
执行 给 定 字 符 串 中 的 SQL 语句 ， 并 返回 一 个 用 于 查看 查询 结果 的 ResultSet WR. 
e int executeUpdate(String sqlStatement) 


e long executeLargeUpdate(String sqlStatement) 8 
执行 字符 串 中 指定 的 INSERT, UPDATE 或 DELETE 等 SQL 语句 。 还 可 以 执行 数据 定义 
语言 ( Data Definition Language, DDL) 的 语句 ， 如 CREATE TABLE。 返 回 受 影响 的 行 
数 ， 如 果 是 没有 更 新 计数 的 语句 ， 则 返回 0。 

e boolean execute(String sqlStatement) 
执行 字符 串 中 指定 的 SQL 语句 。 可 能 会 产生 多 个 结果 集 和 更 新 计数 。 如 果 第 一 个 
执行 结果 是 结果 集 ， 则 返回 true; 反之 ,返回 false。 调 用 getResultset 或 
getUpdateCount 方法 可 以 得 到 第 一 个 执行 结果 。 请 参见 5.5.4 节 中 关于 处 理 多 结果 集 
的 详细 信息 。 

e ResultSet getResultSet() 
返回 前 一 条 查询 语句 的 结果 集 。 如 果 前 一 条 语句 未 产生 结果 集 ， 则 返回 nul) 值 。 对 于 
每 一 条 执行 过 的 语句 ， 该 方法 只 能 被 调用 一 次 。 

e int getUpdateCount() 

è long getLargeUpdateCount() 8 
返回 受 前 一 条 更 新 语句 影响 的 行 数 。 如 果 前 一 条 语句 未 更 新 数据 库 ， 则 返回 -1。 对 于 
每 一 条 执行 过 的 语句 ， 该 方法 只 能 被 调用 一 次 。 

e void close() 
关闭 Statement 对 象 以 及 它 所 对 应 的 结果 集 。 


e boolean isClosed() 6 
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如 果 语 句 被 关闭 ， 则 返回 true, 


e void closeOnCompletion() 7 


使 得 一 旦 该 语句 的 所 有 结果 集 都 被 关闭 ， 则 关闭 该 语句 。 





èe boolean next() 
将 结果 集中 的 当前 行 向 前 移动 一 行 。 如 果 已 经 到 达 最 后 一 行 的 后 面 ， 则 返回 false, 
注意 ， 初 始 情况 下 必须 调用 该 方法 才能 转 到 第 一 行 。 

e Xxx getXxx(int columnNumber ) 

e Xxx getXxx(String columnLabel ) 
(Xxx 指数 据 类 型 ， 例 如 int, double, String 和 Date 等 。) 

e<T> T getObject(int columnIndex, Class<T> type) 7 

e<T> T getObject(String columnLabel, Class<T> type) 7 

ə void updateObject(int columnIndex, Object x, SQLType targetSqiType) 8 

ə void updateObject(String columnLabel, Object x, SQLType targetSqiType) 8 
用 给 定 的 列 序号 或 列 标签 返回 或 更 新 该 列 的 值 ， 并 将 值 转换 成 指定 的 类 型 。 列 标签 是 
SQL 的 AS 子 句 中 指定 的 标签 ， 在 没有 使 用 As 时 ， 它 就 是 列 名 。 

e int findColumn(String columnName) 
根据 给 定 的 列 名 ， 返 回 该 列 的 序号 。 

e void close() 
立即 关闭 当前 的 结果 集 。 

e boolean isClosed() 6 


如 果 该 语句 被 关闭 ， 则 返回 true. 
5.4.2 管理 连接 、 语 句 和 结果 集 


每 个 Connection 对 象 都 可 以 创建 一 个 或 多 个 Statement 对 象 。 同 一 个 Statement 
对 象 可 以 用 于 多 个 不 相关 的 命令 和 查询 。 但 是 ， 一 个 Statement 对 象 最 多 只 能 有 一 个 打 
开 的 结果 集 。 如 果 需 要 执行 多 个 查询 操作 ， 且 需要 同时 分 析 查 询 结果 ， 那 么 必须 创建 多 个 
Statement 对 象 。 

需要 说 明 的 是 ， 至 少 有 一 种 常用 的 数据 库 (Microsoft SQL Server) 的 JDBC 驱动 程 
序 只 人 允许 同时 存在 一 个 活动 的 Statement 对 象 。 使 用 DatabaseMetaData 接口 中 的 
getMaxStatements 方法 可 以 获取 JDBC 驱动 程序 支持 的 同时 活动 的 语句 对 象 的 总 数 。 

这 看 上 去 似乎 很 有 局 限 性 。 但 实际 上 ， 我 们 通常 并 不 需要 同时 处 理 多 个 结果 集 。 如 果 绪 
果 集 相互 关联 ， 我 们 可 以 使 用 组 合 查 询 ， 这 样 就 只 需要 分 析 一 个 结果 。 对 数据 库 进行 组 合 查 
询 比 使 用 Java 程序 遍历 多 个 结果 集 要 高 效 得 多 。 

使 用 完 ResultSet, Statement 或 Connection 对 象 后 ， 应 立即 调用 close 方法 。 这 
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些 对 象 部 使 用 了 规模 较 大 的 数据 结构 ， 它 们 会 占用 数据 库存 服务 器 上 的 有 限 资源 。 

如 果 Statement 对 象 上 有 一 个 打开 的 结果 集 ， 那 么 调用 close 方法 将 自动 关闭 该 结果 
集 。 同 样 地 ， 调 用 Connection 类 的 close 方法 将 关闭 该 连接 上 的 所 有 语句 。 

反 过 来 的 情况 是 ， 在 使 用 JavaSE 7 时 ， 可 以 在 Statement 上 调用 closeOnCompletion 
方法 ， 在 其 所 有 结果 集 都 被 关闭 后 ， 该 语句 会 立即 被 自动 关闭 。 

如 果 所 用 连接 都 是 短 时 的 ， 那 么 无 需 考虑 关闭 语句 和 结果 集 。 只 需 将 close 语句 放 在 带 
资源 的 try 语句 中 ， 以 便 确 保 最 终 连接 对 象 不 可 能 继续 保持 打开 状态 。 

try (Connection conn =...) 

Statement stat = conn.createStatement () ; 


ResultSet result = stat.executeQuery(queryString) ; 
process query result 


O 提示 : 应 该 使 用 带 资源 的 try 语句 块 来 关闭 连接 ， 并 使 用 一 个 单独 的 try/catch RAB 
异常 。 分 离 try 程序 块 可 以 提高 代码 的 可 读 性 和 可 维护 性 。 


5.4.3 分 析 SQL 异常 


每 个 SQLException 都 有 一 个 由 多 个 SQLException 对 象 构 成 的 链 ， 这 些 对 象 可 以 通 
过 getNextException 方法 获取 。 这 个 异常 链 是 每 个 异常 都 具有 的 由 Throwable 对 象 构成 
的 “成 因 ” 链 之 外 的 异常 链 (请 参见 卷 1 第 11 章 以 了 解 Java 异常 的 详细 信息 )， 因 此 ， 我 们 
需要 用 两 个 朋 套 的 循环 来 完整 枚 举 所 有 的 异 弟 。 斑 运 的 是 ，Java SE 6 改进 了 SQLException 
类 ， 让 其 实现 了 Iterable<Throwable> 接 口 ， 其 iterator() 方 法 可 以 产生 一 个 
Iterator<Throwable>， 这 个 迭代 幽 可 以 迭代 这 两 个 链 ， 首 先 迭 代 第 一 个 SQLException 的 
成 因 链 ， 然 后 迭代 下 一 个 SQLException， 以 此 类 推 。 我 们 可 以 直接 使 用 下 面 这 个 改进 的 
for 循环 : 


for (Throwable t : sqlException) 


{ 
do something with t 


可 以 在 SQLException 上 调用 getSQLState 和 getErrorCode 方法 来 进一步 分 析 它 ， 
其 中 第 一 个 方法 将 产生 符合 X/Open 或 SQL:2003 标准 的 字符 串 (调用 DatabaseMetaData 
接口 的 getSQLStateType 方法 可 以 查 出 驱动 程序 所 使 用 的 标准 )。 而 错误 代码 是 与 具体 的 提 
供 商 相关 的 。 

SQL 异常 按照 层次 结构 树 的 方式 组 织 到 了 一 起 (如 图 5-5 所 示 )， 这 使 得 我 们 可 以 按照 与 
提供 商 无 关 的 方式 来 捕获 具体 的 错误 类 型 。 

另外 ， 数 据 库 驱 动 程序 可 以 将 非 致命 问题 作为 警告 报告 ， 我 们 可 以 从 连接 、 语 句 和 结果 
集中 获取 这 些 警告 。SQLWarning 类 是 SQLException 的 子 类 (尽管 SQLWarning 不 会 被 当 
fesse te wih), HAT AT LAV AY getSQLState 和 getErrorCode 来 获取 有 关 和 警告 的 更 多 信息 。 
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5 SQL 异常 类 似 ， 警 告 也 是 串 成 链 的 。 要 获得 所 有 的 警告 ， 可 以 使 用 下 面 的 循环 : 
SQLWarning w = stat.getWarning(); 
while (w != null) 
{ 


do something with w 
w = W.mextWarning(); 
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5-5 SQL 异常 类 型 


当 数 据 从 数据 库 中 读 出 并 意外 被 截断 时 ，SQLWarning 的 DataTruncation 子 类 就 派 上 
用 场 了 。 如 果 数 据 截断 发 生 在 更 新 语句 中 ， 那 么 DataTruncation 将 会 被 当 作 异常 抛 出 。 





e SQLException getNextException() 
返回 链接 到 该 SQL 异常 的 下 一 个 SQL 异常 ， 或 者 在 到 达 链 尾 时 返回 null, 


e Iterator<Throwable> iterator() 6 


SRA a, P AREER SQL 异常 和 它们 的 成 因 。 
e String getSQLState() 


获取 “SQL 状态 ”"， 即 标准 化 的 错误 代码 。 
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e int getErrorCode() 
获取 提供 商 相关 的 错误 代码 。 





eSQLWarning getNextWarning() 
返回 链接 到 该 警告 的 下 一 个 警告 ， 或 者 在 到 达 链 尾 时 返回 null, 







e SQLWarning getWarnings() 
返回 未 处 理 警 告 中 的 第 一 个 ， 或 者 在 没有 未 处 理 警 告 时 返回 null, 





e boolean getParameter( ) 
如 果 在 参数 上 进行 了 数据 截断 ， 则 返回 true; 如 果 在 列 上 进行 了 数据 截断 ， 则 返回 


false, 


e int getIndex() 

返回 被 截断 的 参数 或 列 的 索引 。 
e int getDataSize() 

返回 应 该 被 传输 的 字 节 数量 ， 或 者 在 该 值 未 知 的 情况 下 返回 -1。 
e int getTransferSize() | 


返回 实际 被 传输 的 字 节 数量 ， 或 者 在 该 值 未 知 的 情况 下 返回 -1。 
5.4.4 组 装 数据 库 


至 此 ， 大 家 也 许 都 迫不及待 地 想 编 写 一 个 真正 实用 的 JDBC 程序 了 。 如 果 我 们 可 以 编写 
一 段 程序 来 执行 之 前 所 介绍 的 那些 巧妙 的 查询 ， 那 当然 很 好 。 不 过 ， 在 此 之 前 我 们 还 有 一 个 
问题 没有 解决 : 目前 数据 库 中 还 没有 数据 。 我 们 需要 组 装 数据 库 ， 并 且 也 确实 存在 一 种 简单 
方法 可 以 实现 此 目的 : 用 一 系列 的 SQL 指令 来 创建 数据 表 并 向 其 中 插入 数据 。 大 和 多数 数据 库 
程序 都 可 以 处 理 来 自 文本 文件 中 的 一 系列 SQL 指令 ， 但 是 在 语句 终止 符 和 其 他 一 些 文法 问题 
上 ， 这 些 数据 库 程序 之 间 存 在 着 令 人 讨厌 的 差异 。 

正 是 由 于 这 个 原因 ， 我们 使 用 JDBC 创建 了 一 个 简单 的 程序 ， 它 从 文件 中 读 取 SQL 指 
令 ， 其 中 一 条 指令 占据 一 行 ， 然 后 执行 它们 。 

该 程序 专门 用 于 从 下 列 格 式 的 文本 文件 中 读 取 数据 : 


CREATE TABLE Publishers (Publisher_Id CHAR(6), Name CHAR(30), URL CHAR(80)); 
INSERT INTO Publishers VALUES ('0201', ‘Addison-Wesley’, ‘www.aw-bc.com'); 
INSERT INTO Publishers VALUES ('0471', ‘John Wiley & Sons', ‘www.wiley.com'); 
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程序 清单 5-2 是 用 来 读 取 SQL 语句 文件 以 及 执行 这 些 语句 的 程序 代码 。 通 读 这 些 代 码 并 不 
重要 ,我们 在 这 里 只 是 提供 了 这 样 的 程序 ,使 你 能 够 组 装 数据 库 并 运行 本 章 剩余 部 分 的 代码 。 
请 确认 你 的 数据 库 服 务 器 是 在 运行 的 ， 然 后 可 以 使 用 如 下 方法 运行 该 程序 : 


java -classpath driverPath:. exec.ExecSQL Books.sq] 

java -classpath driverPath:. exec.ExecSQL Authors.sql 
java -classpath driverPath:. exec.ExecSQL Publishers.sq| 
java -classpath driverPath:. exec.ExecSQL BooksAuthors.sq| 


在 运行 程序 之 前 ， 请 检查 一 下 database.properties 文件 是 否 已 经 为 你 的 运行 环境 进行 了 正 
确 设 置 。 请 查看 第 5.3.5 市 。 


注意 : 你 的 数据 库 可 能 也 包含 直接 从 SQL 文件 读 取 的 工具 ， 例 如 ， 在 使 用 Derby 时 ， 
可 以 运行 下 面 的 命令 : 
java -jar derby/lib/derbyrun.jar ij -p 1j.properties Books.sq| 
(ij.properties 文件 在 5.3.3 节 中 描述 过 。) 
在 用 于 ExecSQL 命令 的 数据 格式 中 ， 我 们 允许 每 行 的 结尾 都 可 以 有 一 个 可 选 的 分 
号 ， 因 为 大 多 数 数据 库 工具 都 布 望 使 用 这 种 格式 。 


下 面 将 简要 介绍 一 下 ExecSQL 程序 的 操作 步骤 : 
1) 连接 数据 库 。getCconnection 方法 读 取 database.properties 文件 中 的 属性 信 
息 ， 并 将 属性 jdbc .drivers 添加 到 系统 属性 中 。 驱 动 程序 管理 右 使 用 属性 jdbc .drivers 
加 载 相 应 的 驱动 程序 。getCconnection 方法 使 用 jdbc.ur1、jdbc.username 和 jdbc. 
password 等 属性 打开 数据 库 连 接 。 
2) 使 用 SQL 语句 打开 文件 。 如 果 未 提供 任何 文件 名 ， 则 在 控制 台中 提示 用 户 输入 语句 。 
3 ) 使 用 泛 化 的 execute 方法 执行 每 条 语句 。 如 果 它 返回 true， 则 说 明 该 语句 产生 了 一 
个 结果 集 。 我 们 为 图 书 数据 库 提供 的 4 个 SQL 文件 都 以 一 个 SELECT * 语句 结束 ， 这 样 就 可 
以 看 到 数据 是 否 已 成 功 插入 到 了 数据 库 中 。 
4) 如 果 产 生 了 结果 集 ， 则 打印 出 结果 。 因 为 这 是 一 个 泛 化 的 结果 集 ， 所 以 我 们 必须 使 
用 元 数据 来 确定 该 结果 的 列 数 。 更 多 的 信息 请 查看 5.8 节 。 
5 ) 如 果 运 行 过 程 中 出 现 SQL 异常 ， 则 打印 出 这 个 异常 以 及 所 有 可 能 包含 在 其 中 的 与 其 
链接 在 一 起 的 相关 异常 。 
6 ) 关闭 数据 库 连 接 。 
程序 清单 5-2 给 出 了 该 程序 的 代码 。 





package exec; 
import java.i0.*; 
import java.nio.file.*; 


import java.util.*; 
import java.sql.*; 


Do a Aa w N e 
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7 
8 /** 
9 * Executes all SQL statements in a file. Call this program as <br> 
10 * java -classpath driverPath:. ExecSQL commandFile 
* 


12 * @version 1.32 2016-04-27 
13 * @author Cay Horstmann 


14 */ 

15 Class ExecSQL 

16 { 

17 public static void main(String args[]) throws IOException 
18 { 

19 try (Scanner in = args.length == 0 ? new Scanner(System. in) 
20 : new Scanner(Paths.get(args(0]), “UTF-8")) 

21 { 

22 try (Connection conn = getConnection() ; 

23 Statement stat = conn.createStatement()) 

24 

25 while (true) 

26 

27 if (args. length == 0) System.out.printIn("Enter command or EXIT to exit:"); 
28 

29 if (!in.hasNextLine()) return; 

30 

31 String line = in.nextLine().trimQ; 

32 if (line.equalsIgnoreCase("EXIT")) return; 

33 if (line.endswith(";")) // remove trailing semicolon 
34 { 

35 line = line.substring(0, line.length() - 1); 
36 } 

37 try 

38 { 

39 boolean isResult = stat.execute(line) ; 

40 if (isResult) 

41 { 

42 try (ResultSet rs = stat.getResul tSet()) 
43 

44 ShowResul tSet (rs) ; 

45 } 

46 } 

47 else 

48 { 

49 int updateCount = stat.getUpdateCount () ; 
50 System.out.print]n(updateCount + " rows updated"); 
51 

52 } 

53 catch (SQLException ex) 

54 { 

55 for (Throwable e : ex) 

56 e.printStackTrace() ; 

57 } 

58 } 

59 } 


} 
61 catch (SQLException e) 
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for (Throwable t : e) 
t.printStackTrace() ; 


/** 

* Gets a connection from the properties specified in the file database.properties. 
* @return the database connection 

*/ 

public static Connection getConnection() throws SQLException, IOException 


{ 
Properties props = new Properties(); 
try (InputStream in = Files.newInputStream(Paths.get("database.properties"))) 
{ 
props. load(in); 
} 


String drivers = props.getProperty("jdbc.drivers”) ; 
if (drivers != null) System.setProperty("jdbc.drivers", drivers); 


String url = props.getProperty("jdbc.url") ; 
String username = props.getProperty("jdbc.username") ; 
String password = props.getProperty("jdbc.password") ; 


return DriverManager.getConnection(url, username, password) ; 


} 
/** 


* Prints a result set. 

* @param result the result set to be printed 

ay 
public static void showResultSet (ResultSet result) throws SQLException 


{ 
ResultSetMetaData metaData = result.getMetaData() ; 
int columnCount = metaData.getColumnCount C) ; 


for (int i = 1; i <= columnCount; i++) 


if (i > 1) System.out.print(", "); 
System. out.print(metaData.getColumnLabel (7)) ; 


} 
System.out.printIn(); 


while (result.next()) 
{ 


for (int i = 1; 1 <= columnCount; i++) 


if (i > 1) System.out.print(", "); 
System.out.print(result.getString(i)); 


} 
System.out.printIn(); 
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5.5 ”执行 查询 操作 


在 这 一 节 中 ， 我 们 将 编写 一 段 用 于 对 COREJAVA 数据 库 执行 查询 操作 的 程序 。 为 了 使 程 
序 可 以 正 第 运行 ， 必 须 按 照 上 一 证 中 的 说 明 用 表 组 装 COREJAVA 数据 库 。 

在 查询 数据 库 时 ， 可 以 选择 作者 和 出 版 社 ， 或 者 将 它们 设置 为 “Any”。 

还 可 以 修改 数据 库 中 的 数据 。 选 择 一 家 出 版 社 ， 然 后 输入 金额 。 该 出 版 社 对 应 的 所 有 价 
格 都 将 按照 十 人 的 金额 进行 调整 ， 同 时 程序 将 显示 被 修改 的 行 数 。 修 改 完 价格 以 后 ， 可 以 运 
行 一 个 查询 操作 ， 以 核实 新 的 价格 。 


5.5.1 预备 语句 


在 这 个 程序 中 ， 我 们 使 用 了 一 个 新 的 特性 ， 即 预备 语句 〈prepared statement), WRAY 
虑 作者 字段 ， 我 们 要 查询 某 个 出 版 社 的 所 有 图 书 ， 那 么 该 查询 的 SQL 语句 如 下 : 


SELECT Books.Price, Books.Title 

FROM Books, Publishers 

WHERE Books. Publisher_Id = Publishers.Publisher_Id 
AND Publishers.Name = the name from the list box 


我 们 没有 必要 在 每 次 开始 一 个 这 样 的 查询 时 都 建立 新 的 查询 语句 ， 而 是 准备 一 个 带 有 宿 
主 变 量 的 查询 语句 ， 每 次 查询 时 只 需 为 该 变量 填 入 不 同 的 字符 串 就 可 以 反复 多 次 使 用 该 语 
句 。 这 一 技术 改进 了 查询 性 能 ， 每 当 数 据 库 执行 一 个 查询 时 ， 它 总 是 首先 通过 计算 来 确定 查 
询 策 略 ， 以 便 高 效 地 执行 查询 操作 。 通 过 事先 准备 好 查询 并 多 次 重用 它 ， 我 们 就 可 以 确保 查 
询 所 需 的 准备 步骤 只 被 执行 一 次 。 

在 预备 查询 语句 中 ， 每 个 宿主 变量 都 用 “?” 来 表示 。 如 果 存 在 一 个 以 上 的 变量 ， 那 么 
在 设置 变量 值 时 必须 注意 “? ”的 位 置 。 例 如 ， 如 果 我 们 的 预备 查询 为 如 下 形式 : 


String publisherQuery = 

"SELECT Books.Price, Books.Title" + 

”FROM Books, Publishers" + 

" WHERE Books.Publisher_Id = Publishers. Publisher_Id AND Publishers.Name = ?": 
PreparedStatement stat = conn.prepareStatement (publisherQuery) ; 


在 执行 预备 语句 之 前 ， 必 须 使 用 set 方法 将 变量 绑 定 到 实际 的 值 上 。 和 ResultSet 接 
口中 的 get 方法 类 似 ， 针 对 不 同 的 数据 类 型 也 有 不 同 的 set 方法 。 在 本 例 中 ， 我 们 为 出 版 社 
名 称 设置 了 一 个 字符 串 值 。 

Stat.setString(1, publisher); 

第 一 个 参数 指 的 是 需要 设置 的 宿主 变量 的 位 置 ， 位 置 1 表示 第 一 个 “?”。 第 二 个 参数 指 
的 是 赋予 答 主 变量 的 值 。 

如 果 想 要 重用 已 经 执行 过 的 预备 查询 语句 ， 那 么 除非 使 用 set 方 法 或 调用 
clearParameters 方法 ， 否 则 所 有 宿主 变量 的 绑 定 都 不 会 改变 。 这 就 意味 着 ， 在 从 一 个 查 
询 到 另 一 个 查询 的 过 程 中 ， 只 需 使 用 setXxx 方法 重新 绑 定 那些 需要 改变 的 变量 即 可 。 

一 旦 为 所 有 变量 绑 定 了 具体 的 值 ， 就 可 以 执行 查询 操作 了 : 
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ResultSet rs = stat.executeQuery() ; 


GY 提示: 通过 连接 字符 串 来 手动 构建 查询 显得 非常 枯燥 乏味 ， 而 且 存在 潜在 的 危险 。 你 必 


须 注意 像 引 号 这 样 的 特殊 字符 ,而 且 如 果 查 询 中 涉及 用 户 的 输入 ， 那 就 还 需要 警惕 注入 
攻击 。 因 此 ， 只 有 查询 涉及 变量 时 ， 才 应 该 使 用 预备 语句 。 


价格 更 新 操作 可 以 由 UPDATE 语句 实现 。 请 注意 ， 我 们 调用 的 是 executeUpdate 方法 ， 


而 非 executeQuery 方法 ， 因 为 UPDATE 语句 不 返回 结果 集 。executeUpdate 的 返回 值 为 
被 修改 过 的 行 数 。 


int r = stat.executeUpdate() ; 
System.out.printIn(r + " rows updated"); 


注意 : 在 相关 的 Connection 对 象 关 闭 之 后 ，PreparedStatement 对 象 也 就 变 得 无 效 
J, 不过， 许多 数据 库 通常 都 会 自动 缓存 预备 语句 。 如 果 相 同 的 查询 被 预备 两 次 ， 数 据 
库 通 常会 直接 重用 查询 策略 。 因 此 ， 无 需 过 多 考虑 调用 prepareStatement 的 开销 。 


下 面 简要 说 明了 示例 程序 的 结构 。 

e 通过 执行 两 个 查询 可 以 得 到 数据 库 中 所 有 的 作者 和 出 版 社 名 称 ， 作 者 和 出 版 社 数组 列 
Pe FH Ze IM MK o 

e 涉及 作者 的 查询 比较 复杂 。 因 为 一 本 书 可 能 有 多 个 作者 ，BooksAuthors 表 给 出 了 作 
者 和 图 书 之 间 的 对 应 关系 。 例 如 ，ISBN 号 为 0-201-96426-0 的 图 书 有 两 个 作者 ， 其 代 
号 为 DATE 和 DARW, LI Fy BooksAuthors 表 中 的 两 行 记录 : 


0-201-96426-0, DATE, 1 
0-201-96426-0, DARW, 2 


BooksAuthors 表 中 第 三 列 指 的 是 作者 的 顺序 (我 们 不 能 只 使 用 表 中 行 的 位 置 ， 
在 关系 表 中 没有 固定 的 行 顺 序 )。 因 此 ， 查 询 时 需要 连接 Books 表 、BooksAuthors 
表 和 Authors 表 ， 以 便 和 用 户 所 选 的 作者 名 进行 比较 。 


SELECT Books.Price, Books.Title FROM Books, BooksAuthors, Authors, Publishers 
WHERE Authors.Author Id = BooksAuthors.Author_Id AND BooksAuthors. ISBN = Books. ISBN 
AND Books.Publisher_Id = Publishers.Publisher_Id AND Authors.Name = ? AND Publishers.Name = ? 


提示 : 许多 程序 员 都 不 喜欢 使 用 如 此 复杂 的 SQL 语句 。 比 较 常 见 的 方法 是 使 用 大 量 的 


Java 代码 来 迭代 多 个 结果 集 ， 但 是 这 种 方法 效率 非常 低 。 通 常 ， 使 用 数据 库 的 查询 代码 
要 比 使 用 Java 程序 好 得 多 一 一 这 是 数据 库 的 一 个 重要 优点 。 一 般 而 言 ， 可 以 使 用 SQL 
解决 的 问题 ， 就 不 要 使 用 Java 程序 。 


e change Prices 方法 执行 UPDATE 语句 。 注 意 ，UPDATE 语句 中 的 WHERE 子 句 需要 使 
用 出 版 社 代码 ， 而 我 们 只 知道 出 版 社 名 称 。 这 个 问题 可 以 使 用 和 能 套子 查询 来 解决 。 


UPDATE Books 
SET Price = Price + ? 
WHERE Books.Publisher Id = (SELECT Publisher Id FROM Publishers WHERE Name = ?) 
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程序 清单 5-3 给 出 了 程序 的 完整 代码 。 





package query; 


2 

3 Import java.io.*; 

4 import java.nio.file.*; 
5 import java.sql.*; 

6 import java.util.*; 

7 

8 

9 


/** 
* This program demonstrates several complex database queries. 
10 * @version 1.30 2012-06-05 
11 * @author Cay Horstmann 
2 */ 
13 public class QueryTest 


14 { 
15 private static final String allQuery = "SELECT Books.Price, Books. Title FROM Books": 


17 private static final String authorPublisherQuery = "SELECT Books.Price, Books.Title" 

”FROM Books, BooksAuthors, Authors, Publishers" 

”WHERE Authors.Author_Id = BooksAuthors.Author_Id AND BooksAuthors. ISBN = Books. ISBN" 
" AND Books. Publisher_Id = Publishers.Publisher_Id AND Authors.Name = ?" 

" AND Publishers.Name = ?"; 


pan 
oo 
ES 


m7 
十 十 十 


23 private static final String authorQuery 


24 = "SELECT Books.Price, Books.Title FROM Books, BooksAuthors, Authors" 
25 + " WHERE Authors.Author_Id = BooksAuthors.Author_Id AND BooksAuthors.ISBN = Books. ISBN" 
26 + " AND Authors ,Name = ?": 


28 private static final String publisherQuery 
29 = "SELECT Books.Price, Books.Title FROM Books, Publishers" 
30 + " WHERE Books.Publisher_Id = Publishers.Publisher_Id AND Publishers.Name = ?": 


33 private static final String priceUpdate = "UPDATE Books " + "SET Price = Price +? " 

34 + " WHERE Books.Publisher_Id = (SELECT Publisher_Id FROM Publishers WHERE Name = ?)"; 
36 private static Scanner in; 

37 private static ArrayList<String> authors = new ArrayList<>(); 


38 private static ArrayList<String> publishers = new ArrayList<>(); 


40 public static void main(String[] args) throws IOException 


41 { 

42 try (Connection conn = getConnection()) 

43 { 

44 in = new Scanner(System. in) ; 

45 authors.add("Any"); 

46 publishers.add("Any") ; 

47 try (Statement stat = conn.createStatement ()) 
48 { 

49 // Fill the authors array list 

50 String query = "SELECT Name FROM Authors"; 


} 


private static void executeQuery(Connection conn) throws SQLException 


{ 


try (ResultSet rs = stat.executeQuery(query)) 


while (rs.next()) 
authors.add(rs.getString(1)); 
} 


// Fill the publishers array list 
query = "SELECT Name FROM Publishers"; 
try (ResultSet rs = stat.executeQuery (query) ) 
{ 
while (rs.next()) 
publishers.add(rs.getString(1)) ; 
} 
} 
boolean done = false; 
while (!done) 
{ 
System.out.print("Q)uery C)hange prices E)xit: "); 
String input = in.next().toUpperCase() ; 
if (input.equals("Q")) 
executeQuery (conn) ; 
else if (input.equals("C")) 
changePrices(conn) ; 
else 
done = true; 
} 


} 
catch (SQLException e) 


for (Throwable t : e) 
System.out.printIn(t.getMessage()); 
} 


/** 


* Executes the selected query. 
* @aram conn the database connection 


| 


String author = select(“Authors:", authors); 
String publisher = select("Publishers:", publishers) ; 
PreparedStatement stat; 
if (l!author.equals("Any") && !publisher.equals("Any")) 
{ 
Stat = conn.prepareStatement (authorPublisherQuery) ; 
Stat.setString(1, author); 
Stat.setString(2, publisher); 
} 
else if (!author.equals("Any") && publisher.equals("Any")) 
{ 
Stat = conn.prepareStatement (authorQuery) ; 
stat.setString(1, author); 
} 
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156 
157 


else if (author.equals("Any") && !publisher.equals("Any")) 
{ 
Stat = conn.prepareStatement (publisherQuery) ; 
stat.setString(1, publisher); 


else 
Stat = conn.prepareStatement (al lQuery) ; 


try (ResultSet rs = stat.executeQuery()) 


while (rs.next()) 
System.out.printIn(rs.getString(1) + ", " + rs.getString(2)); 


/** 
* Executes an update statement to change prices. 
* @param conn the database connection 
"i 


public static void changePrices(Connection conn) throws SQLException 


String publisher = select("Publishers:", publishers.subList(1, publishers.size())); 
System.out.print("Change prices by: "); 

double priceChange = in.nextDouble(); 

PreparedStatement stat = conn.prepareStatement (priceUpdate) ; 

Stat.setDouble(1, priceChange) ; 

Stat.setString(2, publisher); 

int r = Sstat.executeUpdate() ; 

System.out.printIn(r + " records updated."); 


} 


/** 

* Asks the user to select a string. 

* @param prompt the prompt to display 

* @param options the options from which the user can choose 

* @return the option that the user chose 

7 

public static String select(String prompt, List<String> options) 


while (true) 


{ 
System. out.printIn(prompt) ; 
for (int i = 0; i < options.size(); i++) 
System.out.printf("%2d) %s%n", 1 + 1, options.get(i)); 
int sel = in.nextInt(); 
if (sel > 0 && sel <= options.size()) 
return options.get(sel - 1); 
} 
/** 


* Gets a connection from the properties specified in the file database.properties. 
* @return the database connection 


人 
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159 public static Connection getConnection() throws SQLException, IOException 


160 { 

161 Properties props = new Properties(); 

162 try (InputStream in = Files.newInputStream(Paths.get (database. properties") )) 
163 

164 props. load(in); 

165 

166 

167 String drivers = props.getProperty("jdbc.drivers’) ; 

168 if (drivers != null) System.setProperty("jdbc.drivers’, drivers); 
169 String url = props.getProperty("jdbc.url"); 

170 String username = props.getProperty("jdbc.username') ; 

171 String password = props.getProperty("jdbc.password") ; 

172 

173 return DriverManager.getConnection(url, username, password) ; 

mo } 

175 } 





e PreparedStatement prepareStatement(String sql) 
返回 一 个 含 预 编 译 语句 的 PreparedStatement 对 象 。 字 符 串 sq1 代表 一 个 SQL if 


外， 该 语句 可 以 包含 一 个 或 多 个 由 ?字符 指明 的 参数 占 位 符 。 








e void setXxx(int n, Xxx x) 
(Xxx {f int, double, String, Date 之 类 的 数据 类 型 ) 设置 第 n 个 参数 值 为 x。 

e void clearParameters() 
清除 预备 语句 中 的 所 有 当前 参数 。 

e ResultSet executeQuery( ) 
执行 预备 SQL 查询 ， 并 返回 一 个 ResultSet WR. 

e int executeUpdate( ) 
执行 预备 SQL 语句 INSERT, UPDATE 或 DELETE， 这 些 语 句 由 PreparedStatement 
对 和 象 表 示 。 该 方法 返回 在 执行 上 述 语句 过 程 中 所 有 受 影响 的 记录 总 数 。 如 果 执 行 的 是 
数据 定义 语言 (DDL) 中 的 语句 ， 如 CREATE TABLE， 则 该 方法 返回 0。 


5.5.2 WRS LOB 


除了 数字 、 字 符 串 和 日 期 之 外 ， 许 多 数据 库 还 可 以 存储 大 对 象 ， 例 如 图 片 或 其 他 数据 。 
在 SQL 中 ,二进制 大 对 象 称 为 BLOB， 字 符 型 大 对 象 称 为 CLOB。 

要 读 取 LOB， 需 要 执行 SELECT 语句 ， 然 后 在 ResultSet 上 调用 getB1ob 或 getClob 
方法 ， 这 样 就 可 以 获得 Blob 或 Clob 类 型 的 对 象 。 要 从 Blob 中 获取 二 进 制 数据 ， 可 以 调用 
getBytes 或 getBinaryStream。 例 如 ， 如 果 你 有 一 张 保 存 图 书 封面 图 像 的 表 ， 那 么 就 可 
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以 像 下 面 这 样 获 取 一 张 图 像 


stat.set(1, isbn); 
try (ResultSet result = stat.executeQuery()) 


{ 
if (result.next()) 
{ 
Blob coverBlob = result.getBlob(1); 
Image coverImage = ImageI0.read(coverBlob.getBinaryStream()) ; 
} 
} 


类 似 地 ， 如 果 获 取 了 Clob 对 象 ， 那 么 就 可 以 通过 调用 getSubString 或 getCharacterStream 
方法 来 获取 其 中 的 字符 数据 。 

要 将 LOB 置 于 数据 库 中 ， 需 要 在 Connection 对 象 上 调用 createBlob 或 createClob, 
然后 获取 一 个 用 于 该 LOB 的 输出 流 或 写 出 器 ， 写 出 数据 ， 并 将 该 对 象 存 储 到 数据 库 中 。 例 
如 ， 下 面 展示 了 如 何 存储 一 张 图 像 : 


Blob coverBlob = connection.createBlob(); 

int offset = 0; 

OutputStream out = coverBlob.setBinaryStream(offset) ; 

Imagel0.write(coverImage, "PNG", out); 

PreparedStatement stat = conn.prepareStatement ("INSERT INTO Cover VALUES (?, ?)"); 
Stat.set(1, isbn); 

Stat.set(2, coverBlob); 

stat.executeUpdate() ; 





e Blob getBlob(int columnIndex) 1.2 
e Blob getBlob(String columnLabel) 1.2 
eClob getClob(int columnIndex) 1.2 
eClob getClob(String columnLabel) 1.2 


获取 给 定 列 的 BLOB 或 CLOB。 








e long length() 


获取 该 BLOB 的 长 度 。 
ebyte[] getBytes(long startPosition, long length) 


获取 该 BLOB 中 给 定 范 围 的 数据 。 
è InputStream getBinaryStream( ) 
e InputStream getBinaryStream(long startPosition, long length) 


返回 一 个 输入 流 ， 用 于 读 取 该 BLOB 中 全 部 或 给 定 范围 的 数据 。 
e OutputStream setBinaryStream(long startPosition) 1.4 


返回 一 个 输出 流 ， 用 于 从 给 定位 置 开 始 写 入 该 BLOB。 
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e long length() 
获取 该 CLOB 中 的 字符 总 数 。 

e String getSubString(long startPosition, long length) 
获取 该 CLOB 中 给 定 范围 的 字符 。 

eReader getCharacterStream( ) 

eReader getCharacterStream(long startPosition, long length) 
返回 一 个 读 入 器 〈 而 不 是 流 )， 用 于 读 取 CLOB 中 全 部 或 给 定 范 围 的 数据 。 

e Writer setCharacterStream(long startPosition) 1.4 


返回 一 个 写 出 器 〈 而 不 是 流 )， 用 于 从 给 定位 置 开 始 写 人 该 CLOB。 
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e Blob createBlob() 6 
eClob createClob() 6 
创建 一 个 空 的 BLOB 或 CLOB。 


5.5.3 SQL 转 义 


“ 转 义 ”语法 是 各 种 数据 库 普 遍 支 持 的 特性 ， 但 是 数据 库 使 用 的 是 与 数据 库 相 关 的 声 法 变 
体 ， 因 此 ， 将 转 义 语法 转译 为 特定 数据 库 的 语法 是 JDBC 驱动 程序 的 任务 之 一 。 

转 义 主要 用 于 下 列 场 景 : 

e 日 期 和 时 间 字 面 常量 

o ia] HERE PRA 

o 调用 存储 过 程 

e 外 连接 

e 在 LIKE 子 句 中 的 转 义 字符 

日 期 和 时 间 字 面 常 量 随 数据 库 的 不 同 而 变化 很 大 。 要 租 人 日 期 或 时 间 字 面 常 量 ， 需 要 按 
HE ISO 8601 格式 (http://www.cl.cam.ac.uk/~mgk25/iso-time.html) 指定 它 的 值 ， 之 后 驱动 程序 
会 将 其 转译 为 本 地 格式 。 应 该 使 用 d、 七 、ts 来 表示 DATE、TIME. 和 TIMESTAMP fË: 

{d '2008-01-24"} 

{t '23:59:59'} 

{ts '2008-01-24 23:59:59.999'} 

标量 函数 (scalar function) 是 指 仅 返 回 单个 值 的 函数 。 在 数据 库 中 包含 大 量 的 函数 ， 但 
是 不 同 的 数据 库 中 这 些 函 数 名 存在 着 差异 。JDBC 规范 提供 了 标准 的 名 字 ， 并 将 其 转译 为 数 
据 库 相关 的 名 字 。 要 调用 函数 ， 需 要 像 下 面 这 样 般 入 标准 的 函数 名 和 参数 : 


{fn left(?, 20)} 
{fn user()} 
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在 JDBC ALE FAT AFR ENE SCH AY PBS CEIR. 

存储 过 程 (stored procedure) 是 在 数据 库 中 执行 的 用 数据 库 相 关 的 语言 编写 的 过 程 。 要 调 
用 存储 过 程 ， 需 要 使 用 call 转 义 命令 ， 在 存储 过 程 没 有 任何 参数 时 ， 可 以 不 用 加 上 括号 。 砾 
外 ， 应 该 用 = 来 捕获 存储 过 程 的 返回 值 : 


{call PROC1(?, ?)} 
{cal] PROC2} 
{call ? = PROC3(?)} 


两 个 表 的 外 连接 (outer join) 并 不 要 求 每 个 表 的 所 有 行 都 要 根据 连接 条 件 进行 匹配 ， 例 
如 ， 假 设 有 如 下 的 查询 : 
SELECT * FROM {oj Books LEFT OUTER JOIN Publishers ON Books.Publisher_Id = Publisher.Publisher_Id} 


这 个 查询 的 执行 结果 中 将 包含 有 Publisher Id Æ Publishers 表 中 没有 任何 匹配 的 
书 ， 其 中 ，Pub1isher_ID 为 NULL 值 的 行 ， 就 表示 不 存在 任何 匹配 。 如 果 应 该 使 用 RIGHT 
OUTER JOIN， 就 可 以 宫 括 没有 任何 匹配 图 书 的 出 版 商 ， 而 使 用 FULL OUTER JOIN 可 以 同 
时 返回 这 两 类 没有 任何 匹配 的 信息 。 由 于 并 非 所 有 的 数据 库 对 于 这 些 连 接 都 使 用 标准 的 写 
法 ， 因 此 需要 使 用 转 义 语法 。 

最 后 一 种 情况 ，_ 和 % 字 符 在 LIKE 子 句 中 具有 特殊 含义 ， 用 来 匹配 一 个 字符 或 一 个 字 
符 序列 。 目 前 并 不 存在 任何 在 字面 上 使 用 它们 的 标准 方式 ， 所 以 如 果 想 要 匹配 所 有 包含 _ 字 
符 的 字符 串 ， 就 必须 使 用 下 面 的 结构 : 

... WHERE ? LIKE %!_% {escape '!'} 

这 里 我 们 将 ! 定义 为 转 义 字符 ， 而 ! 组 合 表示 字面 常量 下 划 线 。 


5.5.4 多 结果 集 


在 执行 存储 过 程 ， 或 者 在 使 用 允许 在 单个 查询 中 提交 多 个 SELECT 语句 的 数据 库 时 ， 一 
个 查询 有 可 能 会 返回 多 个 结果 集 。 下 面 是 获取 所 有 结果 集 的 步 又 : 

1) 使 用 execute 方法 来 执行 SQL 语句 。 

2 ) 获取 第 一 个 结果 集 或 更 新 计数 。 

3 ) 重复 调用 getMoreResults 方法 以 移动 到 下 一 个 结果 集 。 

4) 当 不 存在 更 多 的 结果 集 或 更 新 计数 时 ， 完 成 操作 。 

如 果 由 多 结果 集 构 成 的 链 中 的 下 一 项 是 结果 集 ，execute 和 getMoreResults 方法 将 
返回 true， 而 如 果 在 链 中 的 下 一 项 不 是 更 新 计数 ，getUpdateCount 方法 将 返回 -1。 

下 面 的 循环 可 以 遍历 所 有 的 结果 : 

boolean isResult = stat.execute(command) ; 

boolean done = false; 

while (!done) 

if (isResult) 


ResultSet result = stat.getResultSet(); 
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do something with result 
} 
else 


{ 
int updateCount = stat.getUpdateCount() ; 


if (updateCount >= 0) 

do something with updateCount 
else 

done = true; 


} 
if (!done) isResult = stat.getMoreResults() ; 





® boolean getMoreResults() 

èe boolean getMoreResults(int current) 6 
获取 该 语句 的 下 一 个 结果 集 ，Current 参数 是 CLOSE_CURRENT_RESULT (默认 值 )， 
KEEP_CURRENT_RESULT 或 CLOSE_ALL_RESULTS 之 一 。 如 果 存 在 下 一 个 结果 集 ， 并 


日 它 确实 是 一 个 结果 集 ， 则 返回 true, 


5.5.5 ”获取 自动 生成 的 键 


大 多 数 数据 库 都 支持 某 种 在 数据 库 中 对 行 自 动 编号 的 机 制 。 但 是 ， 不 同 的 提供 商 所 提供 
的 机 制 之 间 存 在 着 很 大 的 差异 ， 而 这 些 自动 编号 的 值 经 常用 作 主 键 。 尽 管 JDBC 没有 提供 独 
立 于 提供 商 的 自动 生成 键 的 解决 方案 ， 但 是 它 提 供 了 获取 自动 生成 键 的 有 效 途径 。 当 我 们 回 
数据 表 中 插入 一 个 新 行 ， 且 其 键 自动 生成 时 ， 可 以 用 下 面 的 代码 来 获取 这 个 键 : 


stat ,exeCuteUpdate(insert9tatement，9tatement ,RETURN_CENERATED_KEY9) ; 
ResultSet rs = stat.getGeneratedKeys() ; 
if (rs.next()) 


{ 
int key = rs.getInt(1) ; 


} 





e boolean execute(String statement, int autogenerated) 1.4 

e int executeUpdate(String statement, int autogenerated) 1.4 
像 前 面 描述 的 那样 执行 给 定 的 SOL 语句 ， 如 果 autogenerated Mik A A Statement. 
RETURN_GENERATED_KEYS， 并 且 该 语句 是 一 条 INSERT 语句 ， 那 么 第 一 列 中 就 是 自动 


生成 的 键 。 


5.6 ”可 滚动 和 可 更 新 的 结果 集 
我 们 前 面 已 经 介绍 过 ， 使 用 ResultSet 接口 中 的 next 方法 可 以 迭代 遍历 结果 集中 的 所 
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有 行 。 对 于 一 个 只 需要 分 析 数 据 的 程序 来 说 ， 这 显然 已 经 足够 了 了。 但是， 如 果 是 用 于 展示 一 
张 表 或 查询 结果 的 可 视 化 数据 显示 《参见 图 5-4 )， 我 们 通常 会 希望 用 户 可 以 在 结果 集 上 前 后 
移动 。 对 于 可 滚动 结果 集 而 言 ， 我 们 可 以 在 其 中 向 前 或 向 后 移动 ， 甚 至 可 以 跳 到 任意 位 置 。 
为 外 ,一旦 向 用 户 显示 了 结果 集中 的 内 容 ， 他 们 就 可 能 希望 编辑 这 些 内 容 。 在 可 更 新 的 
结果 集中 ， 可 以 以 编程 方式 来 更 新 其 中 的 项 ,使 得 数据 库 可 以 自动 更 新 数据 。 我 们 将 在 下 面 


的 小 节 中 讨论 这 些 功 能 。 
5.6.1 ”可 滚动 的 结果 集 


默认 情况 下 ， 结 果 集 是 不 可 滚动 和 不 可 更 新 的 。 为 了 从 查询 中 获取 可 滚动 的 结果 集 ， 必 
须 使 用 下 面 的 方法 得 到 一 个 不 同 的 Statement 对 象 

Statement stat = conn.createStatement(type, concurrency); 

如 果 要 获得 预备 语句 ， 请 调用 下 面 的 方法 : 

PreparedStatement stat = Conn,prepare9tatement(Command，type，COoncurrency) ; 

K 5-6 和 表 5-7 列 出 了 type 和 concurrency 的 所 有 可 能 值 ， 可 以 有 以 下 几 种 选择 : 

een ts BA REE VRS? 如 果 不 需 要 ， 则 使 用 ResultSet. TYPE_FORWARD_ONLY, 

e 如 果 结 果 集 是 可 滚动 的 ， 且 数据 库 在 查询 生成 结果 集 之 后 发 生 了 变化 ， 那 么 是 否 和希 
望 结 果 集 反映 出 这 些 变 化 ? (在 我 们 的 讨论 中 ,我 们 假设 将 可 滚动 的 结果 集 设置 为 
ResultSet .TYPE_SCROLL_INSENSITIVE。 这 个 设置 将 使 结果 集 “ 感 应 ”不 到 查询 结 
束 后 出 现 的 数据 库 变 化 。) 

© 是 否 希望 通过 编辑 结果 集 就 可 以 更 新 数据 库 ?( 详 细 说 明 请 参见 下 一 节 内 容 。) 

表 5-6 ResultSet 类 的 type 值 


值 解 B 
TYPE_FORWARD_ONLY 结果 集 不 能 滚动 (默认 值 ) 
TYPE_SCROLL_INSENSITIVE 结果 集 可 以 滚动 ， 但 对 数据 库 变化 不 敏感 
TYPE_SCROLL_SENSITIVE 结果 集 可 以 滚动 ， 且 对 数据 库 变化 敏感 


表 5-7 ResultSet 类 的 Concurrency 值 


值 解 B 
CONCUR_READ_ONLY 结果 集 不 能 用 于 更 新 数据 库 (默认 值 ) 
CONCUR_UPDATABLE 结果 集 可 以 用 于 更 新 数据 库 


例如 ， 如 果 只 想 深 动 遍 历 结果 集 ， 而 不 想 编辑 它 的 数据 ， 那 么 可 以 使 用 以 下 语句 : 


Statement stat = conn.createStatement ( 
ResultSet. TYPE SCROLL INSENSITIVE, ResultSet. CONCUR_READ ONLY) ; 


现在 ， 通 过 调用 以 下 方法 获得 的 所 有 结果 集 都 将 是 可 滚动 的 。 


ResultSet rs = Stat,executeQuery(query) ; 
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可 滚动 的 结果 集 有 一 个 游标 ， 用 以 指示 当前 位 置 。 


注意 : 并 非 所 有 的 数据 库 驱 动 程序 都 支持 可 滚动 和 可 更 新 的 结果 集 。( 使 用 DatabaseMetaData 
接口 中 的 supportsResultSetType 和 SupportsResultSetConcurrency 方 法， 我 们 可 以 


获知 在 使 用 特定 的 驱动 程序 时 ， 某 个 数据 库 究 竟 支 持 哪些 结果 集 类 型 以 及 哪些 并 发 模式 -) PP 
便 是 数据 库 支 持 所 有 的 结果 集 模式 ， 某 个 特定 的 查询 也 可 能 无 法 产生 带 有 所 请 求 的 所 有 属性 
的 结果 集 。( 例 如 ， 一 个 复杂 查询 的 结果 集 就 有 可 能 是 不 可 更 新 的 结果 集 。) 在 这 种 情况 下 ， 
executeQuery 方法 将 返回 一 个 功能 较 少 的 ResultSet 对 象 ， 并 添加 一 个 SQLWarning 到 连接 
对 象 中 。( 参 见 543 节 有 关 如 何 获取 警告 信息 的 内 容 ) 或 者 ， 也 可 以 使 用 ResultSet 接口 中 的 
getType 和 getConcurrency 方法 查看 结果 集 实 际 支 持 的 模式 。 如 果 不 检 查 结 果 集 的 功 
能 就 发 起 一 个 不 支持 的 操作 ， 比 如 对 不 可 滚动 的 结果 集 调用 previous 方法 ， 那 么 程序 
将 抛 出 一 个 SQLException 异常 。 


在 结果 集 上 滚动 是 非常 简单 的 ， 可 以 使 用 

if (rs.previous()) ，，， 
向 后 滚动 。 如 果 游 标 位 于 一 个 实际 的 行 上 ， 那 么 该 方法 将 返回 true ; 如 果 游 标 位 于 第 一 行 
之 前 ， 那 么 返回 false, 

可 以 使 用 以 下 调用 将 游标 向 后 或 向 前 移动 多 行 : 

rs.relative(n) ; 


sn 为 正 数 ， 游 标 将 向 前 移动 。 如 果 n ARR, Heo. WANA, ABA 
调用 该 方法 将 不 起 任何 作用 。 如 果 试 图 将 游标 移动 到 当前 行 集 的 范围 之 外 ， 即 根据 n 值 的 正 
负 号 ， 游 标 需要 被 设置 在 最 后 一 行 之 后 或 第 一 行 之 前 ， 那 么 ， 该 方法 将 返回 false, HAB 
动 游标 。 如 果 游 标 位 于 一 个 实际 的 行 上 ， 那 么 该 方法 将 返回 true, 

或 者 ， 还 可 以 将 游标 设置 到 指定 的 行 号 上 : 

rs.absolute(n); 

调用 以 下 方法 将 返回 当前 行 的 行 号 : 

int currentRow = rs.getRow(); 

结果 集中 第 一 行 的 行 号 为 1。 如果 返 回 值 为 0， 那 么 当前 游标 不 在 任何 行 上 ， 它 要 么 位 
于 第 一 行 之 前 ， 要 么 位 于 最 后 一 行 之 后 。 

first, last, beforeFirst 和 afterLast 这 些 简便 方法 用 于 将 游标 移动 到 第 一 行 、 
最 后 一 行 、 第 一 行 之 前 或 最 后 一 行 之 后 。 

最 后 ，isFirst、isLast、isBeforeFirst 和 isAfterLast 用 于 测试 游标 是 否 位 于 
这 些 特 殊 位 置 上 。 

使 用 可 滚动 的 结果 集 是 非常 简单 的 ， 将 查询 数据 放 入 缓存 中 的 复杂 工作 是 由 数据 库 驱 动 
程序 在 后 台 完 成 的 。 


i 
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5.6.2 ”可 更 新 的 结果 集 


如 果 希 望 编辑 结果 集中 的 数据 ， 并 且 将 结果 集 上 的 数据 变更 自动 反映 到 数据 库 中 ,那么 
就 必须 使 用 可 更 新 的 结果 集 。 可 更 新 的 结果 集 并 非 必须 是 可 深 动 的 ， 但 如 果 将 数据 提供 给 用 
户 去 编辑 ， 那 么 通常 也 会 希望 结果 集 是 可 滚动 的 。 

如 果 要 获得 可 更 新 的 结果 集 ， 应 该 使 用 以 下 方法 创建 一 条 语句 : 


Statement stat = conn.createStatement ( 
ResultSet. TYPE _SCROLL_INSENSITIVE, Resul tSet.CONCUR_UPDATABLE) ; 


这 样 ， 调 用 executeQuery 方法 返回 的 结果 集 就 将 是 可 更 新 的 结果 集 。 


注意 : 并 非 所 有 的 查询 都 会 返回 可 更 新 的 结果 集 。 如 果 查 询 涉 及 多 个 表 的 连接 操作 ， 那 
么 它 所 产生 的 结果 集 将 是 不 可 更 新 的 。 如 果 查 询 只 涉及 一 个 表 ， 或 者 在 查询 时 是 使 用 主 
键 连接 多 个 表 的 ， 那 么 它 所 产生 的 结果 集 将 是 可 更 新 的 结果 集 。 可 以 调用 ResultSet 接 
口中 的 getConcurrency 方法 来 确定 结果 集 是 否 是 可 更 新 的 。 


例如 ， 假 设想 提高 某 些 图 书 的 价格 ， 但 是 在 执行 UPDATE 语句 时 又 没有 一 个 简单 而 统一 
的 提 价 标准 。 此 时 ， 就 可 以 根据 任意 设 定 的 条 件 ， 和 迭代 遍历 所 有 的 图 书 并 更 新 它们 的 价格 。 


String query = "SELECT * FROM Books"; 
ResultSet rs = stat.executeQuery (query) ; 
while (rs.next()) 


If bs « a) 
{ 
double increase=... 
double price = rs.getDouble("Price") ; 
rs.updateDouble("Price", price + increase); 
rs.updateRow(); // make sure to call updateRow after updating fields 
} 
} 


所 有 对 应 于 SQL 类 型 的 数据 类 型 都 配 有 updateXxx 方 法 ， 比 如 updateDouble、 
updateString 等 。 与 getXxx 方法 相同 ， 在 使 用 updateXxx 方法 时 必须 指定 列 的 名 称 或 序 
号 。 然 后 ， 你 可 以 给 该 字段 设置 新 的 值 。 


注意 : 在 使 用 第 一 个 参数 为 列 序号 的 updateXxx 方法 时 ， 请 注意 这 里 的 列 序号 指 的 是 该 

列 在 结果 集中 的 序号 。 它 的 值 可 以 与 数据 库 中 的 列 序号 不 同 。 

updatexxx 方法 改变 的 只 是 结果 集中 的 行 值 ， 而 非 数 据 库 中 的 值 。 当 更 新 完 行 中 的 字段 
值 后 ， 必 须 调用 updateRow 方法 ， 这 个 方法 将 当前 行 中 的 所 有 更 新 信息 发 送 给 数据 库 。 如 
果 没 有 调用 updateRow 方法 就 将 游标 移动 到 其 他 行 上 ， 那 么 对 此 行 所 做 的 所 有 更 新 都 将 被 
丢弃 而且 永远 也 不 会 被 传递 给 数据 库 。 还 可 以 调用 cance1RowUpdates 方法 来 取消 对 当 
前 行 的 更 新 。 

我 们 在 前 面 的 例子 中 已 经 介绍 过 如 何 修改 一 个 现 有 的 行 。 如 果 想 在 数据 库 中 添加 一 条 新 
的 记录 ， 首 先 需 要 使 用 moveToInsertRow 方法 将 游标 移动 到 特定 的 位 置 ， 我 们 称 之 为 插入 
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47 (insert row). SRG, JAF updatexxx 方法 在 插 和 信行 的 位 置 上 创建 一 个 新 的 行 。 在 上 述 操 
作 全 部 完成 之 后 ， 还 需要 调用 insertRow 方法 将 新 建 的 行 发 送 给 数据 库 。 完 成 插入 操作 后 ， 
再 调用 moveToCurrentRow 方法 将 游标 移 回 到 调用 moveToInsertRow 方 法 之 前 的 位 置 。 
下 面 是 一 段 示 例 程 序 : 


rs.moveToInsertRow() ; 
rs.updateString("Title", title); 
rs.updateString("ISBN", isbn); 
rs,updateString("Publisher_Id", pubid); 
rs.updateDouble("Price", price); 

rs. insertRow() ; 

rs.moveToCurrentRow() ; 


请 注意 ， 你 无 法 控制 在 结果 集 或 数据 库 中 添加 新 数据 的 位 置 。 

对 于 在 插入 行 中 没有 指定 值 的 列 ， 将 被 设置 为 SQL 的 NULL。 但 是 ， 如 果 这 个 列 有 NOT 
NULL 约束 ， 那 么 将 会 抛 出 异常 ， 而 这 一 行 也 无 法 插入 。 

最 后 需要 说 明 的 是 ， 你 可 以 使 用 以 下 方法 删除 游标 所 指 的 行 。 

rs.deleteRow() ; 

deleteRow 方法 会 立即 将 该 行 从 结果 集 和 数据 库 中 删除 。 

ResultSet 接口 中 的 updateRow、insertRow 和 deleteRow 方法 的 执行 效果 等 同 于 
SQL 命令 中 的 UPDATE, INSERT 和 DELETE。 不过， 习惯 于 Java 编程 语言 的 程序 员 通 笛 会 沉 
得 使 用 结果 集 来 操控 数据 库 要 比 使 用 SQL 语句 自然 得 多 。 


O 警告 如 果 不 小 心 处 理 的 话 ， 就 很 有 可 能 在 使 用 可 更 新 的 结果 集 时 编写 出 非常 低 效 的 代 
码 。 执 行 UPDATE 语句 ， 要 比 建立 一 个 查询 ， 然 后 一 边 遍历 一 边 修 改 数据 显得 高 效 得 多 。 
对 于 用 户 能 够 任意 修改 数据 的 交互 式 程序 来 说 ， 使 用 可 更 新 的 结果 集 是 非常 有 意义 的 。 
但 是 ， 对 大 多 数 程序 性 的 修改 而 言 ， 使 用 SQL 的 UPDATE 语句 更 合适 一 些 。 


注意 : JDBC 2 对 结果 集 做 了 进一步 的 改进 ， 例 如 ， 如 果 数 据 被 其 他 的 并 发 数据 库 连 接 所 
修改 ， 那 么 它 可 以 用 最 新 的 数据 来 更 新 结果 集 。JDBC 3 添加 了 另 一 种 优化 ， 可 以 指定 
结果 集 在 事务 提交 时 的 行为 。 但 是 ， 这 些 高 级 特性 超出 了 本 章 的 范围 。 我 们 推荐 你 参考 
Maydene Fisher, Jon Ellis 和 Jonathan Bruce 所 著 的 《 JDBC API Tutorial and Reference, 
Third Edition ) (Addison-Wesley 出 #4 #4 2003 4F 出 版 ) e www.oracle.com/technetwork/ 
java/javase/tech/index-jsp-136101.html 处 的 JDBC 规范 ， 以 了 解 更 多 的 信息 。 


e Statement createStatement(int type, int concurrency) 1.2 

e PreparedStatement prepareStatement(String command, int type, int 
concurrency) 1.2 
创建 一 个 语句 或 预备 语句 ， 且 该 语句 可 以 产生 指定 类 型 和 并 发 模式 的 结果 集 。 
参数 : command 要 预备 的 命令 
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type ResultSet 接口 中 的 下 述 常 量 之 一 : TYPE_FORWARD_ONLY、 
TYPE_SCROLL_INSENSITIVE 或 者 TYPE_SCROLL_SENSITIVE 

concurrency ResultSet 接口 中 的 下 述 常 量 之 一 :. CONCUR_READ_ONLY 
或 者 CONCUR_UPDATABLE 








eint getType() 1.2 
返回 结果 集 的 类 型 。 返 回 值 为 以 下 常量 之 一 : TYPE_FORWARD_ONLY、TYPE_SCROLL_ 
INSENSITIVE sk TYPE_SCROLL_SENSITIVE, 
e int getConcurrency() 1.2 
返回 结果 集 的 并 发 设置 。 返 回 值 为 以 下 常量 之 一 : CONCUR_READ_ONLY 或 CONCUR_ 
UPDATABLE 
e boolean previous() 1.2 
将 游标 移动 到 前 一 行 。 如 果 游 标 位 于 某 一 行 上 ， 则 返回 true; 如 果 游 标 位 于 第 一 行 之 
前 的 位 置 ， 则 返回 false, 
èe int getRow() 1.2 
得 到 当前 行 的 序号 。 所 有 行 从 1 开始 编号 。 
e boolean absolute(int r) 1.2 
移动 游标 到 第 T 行 。 如 果 游 标 位 于 某 一 行 上 ， 则 返回 true, 
e boolean relative(int d) 1.2 
将 游标 移动 4 行 。 如 果 d 为 负数 ， 则 游标 向 后 移动 。 如 果 游 标 位 于 某 一 行 上 ， 则 返回 true, 
e boolean first() 1.2 
e boolean last() 1.2 
移动 游标 到 第 一 行 或 最 后 一 行 。 如 果 游 标 位 于 某 一 行 上 ， 则 返回 true, 
e void beforeFirst() 1.2 
evoid afterLast() 1.2 
移动 游标 到 第 一 行 之 前 或 最 后 一 行 之 后 的 位 置 。 
e boolean isFirst() 1.2 
e boolean isLast() 1.2 
测试 游标 是 否 在 第 一 行 或 最 后 一 行 。 
eboolean isBeforeFirst() 1.2 
èe boolean isAfterLast() 1.2 
测试 游标 是 否 在 第 一 行 之 前 或 最 后 一 行 之 后 的 位 置 。 
e void moveToInsertRow() 1.2 
移动 游标 到 插入 行 。 插 入 行 是 一 个 特殊 的 行 ， 可 以 在 该 行 上 使 用 updateXxx 和 insertRow 
方法 来 插入 新 数据 。 
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e void moveToCurrentRow() 1.2 
将 游标 从 插入 行 移 回 到 调用 moveToInsertRow 方法 之 前 它 所 在 的 那 一 行 。 
evoid insertRow() 1.2 
将 插入 行 上 的 内 容 插 入 到 数据 库 和 结果 集中 。 
e void deleteRow() 1.2 
从 数据 库 和 结果 集中 删除 当前 行 。 
e void updateXxxint column, Xxx data) 1.2 
e void updateXxx(String columnName, Xxx data) 1.2 
(Xxx 指数 据 类 型 ， 比 如 int, double, String, Date 等 ) 更 新 结果 中 当前 行 上 的 东 
个 字段 值 。 
e void updateRow() 1.2 
将 当前 行 的 更 新 信息 发 送 到 数据 库 。 
e void cancelRowUpdates() 1.2 


撤销 对 当前 行 的 更 新 。 





eboolean supportsResultSetType(int type) 1.2 
如 果 数 据 库 支持 给 定 类 型 的 结果 集 ， 则 返回 true, type 是 ResultSet 接口 中 的 常量 之 一 : 
TYPE_FORWARD_ONLY、TYPE_SCROLL_INSENSITIVE 或 者 TYPE_SCROLL_SENSITIVE。 

e boolean supportsResultSetConcurrency(int type, int concurrency) 1.2 


如 果 数 据 库 支持 给 定 类 型 和 并 发 模式 的 结果 集 ， 则 返回 true. 


参数 : type ResultSet 接口 中 的 下 述 常 量 之 一 : TYPE_FORWARD_ 
ONLY、TYPE_SCROLL_INSENSITIVE 或 # TYPE_SCROLL_ 
SENSITIVE 


concurrency ResultSet 接口 中 的 下 述 常量 之 一 : CONCUR_READ_ONL 或 
者 CONCUR_UPDATABLE 
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可 滚动 的 结果 集 虽 然 功 能 强大 ， 却 有 一 个 重要 的 缺陷 : 在 与 用 户 的 整个 交互 过 程 中 ， 
必须 始终 与 数据 库 保 持 连接 。 用 户 也 许 会 离开 电脑 旁 很 长 一 段 时 间 ， 而 在 此 期 间 却 始终 所 
有 着 数据 库 连 接 。 这 种 方式 存在 很 大 的 问题 ， 因 为 数据 库 连 接 属于 稀有 资源 。 在 这 种 情况 
下 ,我 们 可 以 使 用 行 集 。RowSet 接口 扩展 自 ResultSet 接口 ， 却 无 需 始终 保持 与 数据 库 的 
连接 。 

行 集 还 适用 于 将 查询 结果 移动 到 复杂 应 用 的 其 他 层 ， 或 者 是 诸如 手机 之 类 的 其 他 设备 
中 。 你 可 能 从 未 考虑 过 移动 一 个 结果 集 ， 因 为 它 的 数据 结构 非常 庞大 ， 且 依赖 于 数据 连接 。 
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5.7.1 构建 行 集 


以 下 为 javax.sql.rowset 包 提 供 的 接口 ， 它 们 都 扩展 了 RowSet 接口 . 

e CachedRowSet 人 允许 在 断 开 连接 的 状态 下 执行 相关 操作 。 关 于 被 缓存 的 行 集 我 们 将 在 
下 一 节 中 讨论 。 

e WebRowSet 对 象 代 表 了 一 个 被 缓存 的 行 集 ， 该 行 集 可 以 保存 为 XML 文件 。 该 文件 可 
以 移动 到 Web 应 用 的 其 他 层 中 ， 只 要 在 该 层 中 使 用 另 一 个 WebRowSet 对 象 重 新 打开 
该 文件 即 可 。 

e FilteredRowSet 和 JoinRowSet 接口 支持 对 行 集 的 轻 量 级 操作 ， 它 们 等 同 于 SQL 中 
的 SELECT 和 JOIN 操作 。 这 两 个 接口 的 操作 对 象 是 存储 在 行 集中 的 数据 ， 因 此 运行 时 
无 需 建立 数据 库 连 接 。 

e JdbcRowSet ResultSet 接口 的 一 个 瘦 包 装 器 。 它 在 RowSet 接口 中 添加 了 有 用 的 
His 

在 Java 7 中 ， 有 一 种 获取 行 集 的 标准 方式 : 


RowSetFactory factory = RowSetProvider.newFactory() ; 
CachedRowSet crs = factory.createCachedRowSet () ; 


获取 其 他 行 集 类 型 的 对 象 也 有 类 似 的 方法 。 

在 Java 7 之 前 ， 创 建行 集 的 方法 都 是 与 供应 商 相关 的 。 另 外 ，JDK 在 com.sun.rowset 
中 还 提供 了 参考 实现 ， 这 些 实现 类 的 名 字 以 Impl 结尾 ， 例 如 CachedRowSetImp1。 如 果 你 
无 法 使 用 RowSetProvider， 那 么 可 以 使 用 下 面 的 类 取而代之 : 


CachedRowSet crs = new com. sun. rowset.CachedRowSetImp] () ; 
5.7.2 ”被 缓存 的 行 集 


一 个 被 缓存 的 行 集中 包含 了 一 个 结果 集中 所 有 的 数据 。CachedRowSet $Œ ResultSet 
接口 的 子 接口 ， 所 以 你 完全 可 以 像 使 用 结果 集 一 样 来 使 用 被 缓存 的 行 集 。 被 缓存 的 行 集 有 
一 个 非常 重要 的 优点 : 断 开 数据 库 连 接 后 仍然 可 以 使 用 行 集 。 你 将 在 程序 清单 5-4 的 示例 
程序 中 看 到 ， 这 种 做 法 大 大 简化 了 交互 式 应 用 的 实现 。 在 执行 每 个 用 户 命 令 时 ， 我们 只 需 
打开 数据 库 连 接 、 执 行 查询 操作 、 将 查询 结果 放 入 被 缓存 的 行 集 ， 然 后 关闭 数据 库 连接 
即 可 。 

我 们 甚至 可 以 修改 被 缓存 的 行 集中 的 数据 。 当 然 ， 这 些 修改 不 会 立即 反馈 到 数据 库 中 。 
相反 ， 必 须发 起 一 个 显 式 的 请 求 ， 以 便 让 数据 库 真正 接受 所 有 修改 。 此 时 CachedRowSet 类 
会 重新 连接 到 数据 库 ， 并 通过 执行 SQL 语句 向 数据 库 中 写 人 所 有 修改 后 的 数据 。 

可 以 使 用 一 个 结果 集 来 填充 CachedRowSet 对 象 : 


ResultSet result =.. .5 

RowSetFactory factory = RowSetProvider.newFactory() ; 
CachedRowSet crs = factory.createCachedRowSet () ; 
crs.populate(result) ; 

conn.close(); // now OK to close the database connection 


BSE KEE 271 


或 者 ， 也 可 以 让 CachedRowSet 对 象 自动 建立 一 个 数据 库 连 接 。 首 先 ， 设 置 数据 库 参 数 : 


crs. setURL("jdbc:derby://localhost:1527/COREJAVA") ; 
crs.setUsername("dbuser") ; 
crs.setPassword("secret'); 


然后 ， 设 置 查询 语句 和 所 有 人 参数。 


crs.setCommand("SELECT * FROM Books WHERE Publisher_ID = ?"); 
crs.setString(1, publisherId) ; 


最 后 ， 将 查询 结果 填充 到 行 集 中 : 

crs.execute() ; 
这 个 方法 调用 会 建立 数据 库 连 接 、 执 行 查 询 操 作 、 填 充 行 集 ， 最 后 断 开 连 接 。 

如 果 查 询 结果 非常 大 ， 那 我 们 肯定 不 想 将 其 全 部 放 和 人行 集 中 。 毕 竟 ， 用 户 可 能 只 是 想 浏 
览 其 中 的 几 行 而 已 。 在 这 种 情况 下 ， 可 以 指定 每 一 页 的 尺寸 : 


CachedRowSet crs=...3 
crs.setCommand (command) ; 
crs. setPageSize(20) ; 


crs. execute() ; 
现在 就 能 只 获得 20 行 了 。 要 获取 下 一 批 数据 ， 可 以 调用 : 
crs.nextPage() ; 


可 以 使 用 与 结果 集中 相同 的 方法 来 查看 和 修改 行 集中 的 数据 。 如 果 修 改 了 行 集中 的 内 
， 那 么 必须 调用 以 下 方法 将 修改 写 回 到 数据 库 中 : 


crs.acceptChanges (conn) ; 


ws 


crs.acceptChanges () ; 


只 有 在 行 集中 设置 了 连接 数据 库 所 需 的 信息 (如 URL、 用 户 名 和 密码 ) 时 ， 上 述 第 二 个 
方法 调用 才 会 有 效 。 

在 第 5.6.2 节 中， 我 们 曾经 介绍 过 ， 并 非 所 有 的 结果 集 都 是 可 更 新 的 。 同 样 ， 如 采 一 个 
行 集 包 含 的 是 复杂 查询 的 查询 结果 ， 那 么 我 们 就 无 法 将 对 行 集 数据 的 修改 写 回 到 数据 库 中。 
不 过 ， 如 果 行 集 上 的 数据 都 来 自 同 一 张 数据 库 表 ， 我 们 就 可 以 安全 地 写 回 数据 。 


O 警告 : 如 果 是 使 用 结果 集 来 填充 行 集 ， 那 么 行 集 就 无 从 获知 需要 更 新 数据 的 数据 库 表 名 。 

此 时 ， 必 须 调用 setTable 方法 来 设置 表 名 称 。 

另 一 个 导致 问题 复杂 化 的 情况 是 : 在 填充 了 行 集 之 后 ， 数 据 库 中 的 数据 发 生 了 改变 ， 这 
显然 容易 造成 数据 不 一 致 性 。 为 了 解决 这 个 问题 ， 参 考 实现 会 首先 检查 行 集中 的 原始 值 〈 即 ， 
修改 前 的 值 ) 是 否 与 数据 库 中 的 当前 值 一 致 。 如 果 一 致 ， 那 么 修改 后 的 值 将 覆盖 数据 库 中 的 
当前 值 。 否 则 ,将 抛 出 SyncProviderException 异常 ， 且 不 向 数据 库 写 回 任何 值 。 在 实现 
行 集 接口 时 其 他 实现 也 可 以 采用 不 同 的 同步 策略 。 


l 
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e String getURL( ) 
e void setURL(String url) 
获取 或 设置 数据 库 的 URL. 


e String getUsername( ) 


evoid setUsername(String username) 
获取 或 设置 连接 数据 库 所 需 的 用 户 名 。 
e String getPassword( ) 
e void setPassword(String password) 
获取 或 设置 连接 数据 库 所 需 的 密码 。 
e String getCommand( ) 
e void setCommand(String command) 
获取 或 设置 回 行 集中 填充 数据 时 需要 执行 的 命令 。 
e void execute'( ) 
通过 执行 使 用 setCommand 方法 设置 的 语句 集 来 填充 行 集 。 为 了 使 驱动 管理 器 可 以 获 
得 连接 ， 必 须 事先 设 定 URL、 用 户 名 和 密码 。 





e void execute(Connection conn) 
通过 执行 使 用 setCommand 方法 设置 的 语句 集 来 填充 行 集 。 该 方法 使 用 给 定 的 连接 ， 
并 负责 关闭 它 。 

e void populate(ResultSet result) 


将 指定 的 结果 集中 的 数据 填充 到 被 缓存 的 行 集中 。 
e String getTableName( ) 


e void setTableName(String tableName) 
获取 或 设置 数据 库 表 名 称 ， 填 充 被 缓存 的 行 集 时 所 需 的 数据 来 自 该 表 。 
e int getPageSize() 
e void setPageSize(int size) 
获取 和 设置 页 的 尺寸 。 
e boolean nextPage( ) 
e boolean previousPage( ) 
加 载 下 一 页 或 上 一 页 ， 如 果 要 加 载 的 页 存在 ， 则 返回 true, 
e void acceptChanges() 
e void acceptChanges(Connection conn) 
重新 连接 数据 库 ， 并 写 回 行 集中 修改 过 的 数据 。 如 果 因 为 数据 库 中 的 数据 已 经 被 修改 
而 导致 无 法 写 回 行 集 中 的 数据 ， 该 方法 可 能 会 抛 出 SyncProviderException 异常 。 
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e static RowSetFactory newFactory() 
创建 一 个 行 集 工厂 。 

e CachedRowSet createCachedRowSet( ) 

e FilteredRowSet createFilteredRowSet( ) 

e JdbcRowSet createJdbcRowSet( ) 

e JoinRowSet createJoinRowSet( ) 

ə WebRowSet createWebRowSet( ) 
创建 一 个 指定 类 型 的 行 集 。 


5.8 元 数据 


在 前 几 节 中 ， 我 们 介绍 了 如 何 填充 、 查 询 和 更 新 数据 库 表 。 其 实 ，JDBC 还 可 以 提供 关于 
数据 库 及 其 表 结构 的 详细 信息 。 例 如 ， 可 以 获取 某 个 数据 库 的 所 有 表 的 列表 ， 也 可 以 获得 某 个 
表 中 所 有 列 的 名 称 及 其 数据 类 型 。 如 果 是 在 开发 业务 应 用 时 使 用 事先 定义 好 的 数据 库 ， 那 么 数 
据 库 结构 和 表 信 息 就 不 是 非常 有 用 了 。 毕 竟 ， 在 设计 数据 库 表 时 ， 就 已 经 知道 了 它们 的 结构 。 
但 是 ， 对 于 那些 编写 数据 库 工具 的 程序 员 来 说 ， 数 据 库 的 结构 信息 却 是 极其 有 用 的 。 

在 SQL 中 ,描述 数据 库 或 其 组 成 部 分 的 数据 称 为 元 数据 (区别 于 那些 存在 数据 库 中 的 实 
际 数据 )。 我 们 可 以 获得 三 类 元 数据 : 关于 数据 库 的 元 数据 、 关 于 结果 和 集 的 元 数据 以 及 关于 
预备 语句 参数 的 元 数据 。 

如 果 要 了 解数 据 库 的 更 多 信息 ， 可 以 从 数据 库 连 接 中 获取 一 个 DatabaseMetaData 对 象 。 

DatabaseMetaData meta = conn.getMetaData() ; 

现在 就 可 以 获取 某 些 元 数据 了 。 例 如 ， 调 用 

DatabaseMetaData meta = conn.getMetaData() ; 

将 返回 一 个 包含 所 有 数据 库 表 信息 的 结果 集 〈 如 果 要 了 解 该 方法 的 其 他 参数 ， 请 参见 本 节 末 
尾 的 API 说 明 )。 

该 结果 集中 的 每 一 行 都 包含 了 数据 库 中 一 张 表 的 详细 信息 ， 其 中 ， 第 三 列 是 表 的 名 称 。 

(同样 ， 如 果 要 了 解 其 他 列 的 信息 ， 请 参阅 API 说 明 。) 下 面 的 循环 可 以 获取 所 有 的 表 名 : 


while (mrs.next()) 
tableNames.addItem(mrs.getString(3)); 


数据 库 元 数据 还 有 第 二 个 重要 应 用 。 数 据 库 是 非常 复杂 的 ，SQL 标准 为 数据 库 的 多 样 性 
提供 了 很 大 的 空间 。DatabaseMetaData 接口 中 有 上 百 个 方法 可 以 用 于 查询 数据 库 的 相关 信 
息 ， 包 括 一 些 使 用 奇特 的 名 字 进 行 调用 的 方法 ， 如 : 

meta. supportsCatalogsInPrivilegeDefinitions() 


和 
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meta.nul 1 PlusNonNul lIsNul1 () 

显然 ， 这 些 方法 主要 是 针对 有 特殊 要 求 的 高 级 用 户 的 ， 尤 其 是 那些 需要 编写 涉及 多 个 数 
据 库 且 具有 高 可 移植 性 的 代码 的 编程 人 员 。 

DatabaseMetaData 接 口 用 于 提供 有 关 数 据 库 的 数据 ， 第 二 个 元 数据 接口 
ResultSetMetaData 则 用 于 提供 结果 集 的 相关 信息 。 每 当 通 过 查询 得 到 一 个 结果 集 时 ， 我 们 
都 可 以 获取 该 结果 集 的 列 数 以 及 每 一 列 的 名 称 、 类 型 和 字段 宽度 。 下 面 是 一 个 典型 的 循环 : 


ResultSet rs = stat.executeQuery("SELECT * FROM " + tableName) ; 
ResultSetMetaData meta = rs.getMetaData() ; 
for (int 1 = 1; 1 <= meta.getColumnCount(); i++) 


{ 
String columnName = meta.getColumnLabel (i) ; 
int columnWidth = meta.getColumnDisplaySize(i) ; 
om 
在 这 一 节 中 ， 我 们 将 介绍 如 何 编写 一 个 简单 的 数据 库 工 具 ， 程 序 清单 5-4 中 的 程序 通过 
使 用 元 数据 来 浏览 数据 库 中 的 所 有 表 ， 该 程序 还 展示 了 如 何 使 用 带 缓 存 的 行 集 。 





package view; 

import java.awt.*; 
import java.awt.event.*; 
import java.i0.*; 
import java.nio.file.*; 
import java.sql.*; 
import java.util.*; 


tO ®© Nu mm n A u N j 


10 import javax.sql.*; 
11 import javax.sq].rowset.*; 
12 import javax. swing. *; 


u /** 

15 * This program uses metadata to display arbitrary tables in a database. 
16 * @version 1.33 2016-04-27 

17 * @author Cay Horstmann 


1. */ 

19 public class ViewDB 

2 { 

21 public static void main(String[] args) 

22 { 

23 EventQueue.invokeLater(() -> 

24 { 

25 JFrame frame = new ViewDBFrame() ; 
26 frame.setTitle("ViewDB") ; 

27 frame. setDefaul tC] oseOperation(JFrame.EXIT_ON_CLOSE) ; 
28 frame.setVisible(true) ; 

29 D 

30 } 
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/** 
* The frame that holds the data panel and the navigation buttons. 
* 
/ 
class ViewDBFrame extends JFrame 
{ ， 
private JButton previousButton; 
private JButton nextButton; 
private JButton deleteButton; 
private JButton saveButton; 
private DataPanel dataPanel; 
private Component scrollPane; 
private JComboBox<String> tableNames; 
private Properties props; 
private CachedRowSet crs; 
private Connection conn; 


public ViewDBFrame() 
{ 


tableNames = new JComboBox<String>() ; 


try 
{ 
readDatabaseProperties(); 
conn = getConnection() ; 
DatabaseMetaData meta = conn.getMetaData() ; 


try (ResultSet mrs = meta.getTables(null, null, null, new String[] { "TABLE" })) 


{ 
while (mrs.next()) 
tableNames.addItem(mrs.getString(3)); 
} 


catch (SQLException ex) 


{ 
for (Throwable t : ex) 
t.printStackTrace() ; 


catch (IOException ex) 
{ 


ex.printStackTrace() ; 


} 


tableNames. addActionListener( 

event -> showlable((String) tableNames.getSelectedItem(), conn)); 
add(tableNames, BorderLayout.NORTH) ; 
addWindowListener(new WindowAdapter () 


public void windowClosing(WindowEvent event) 
{ 
try 


if (conn != null) conn.close(); 


} 
catch (SQLException ex) 
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} 


/** 

* prepares the text fields for showing a new table, and shows the first row, 
* @param tableName the name of the table to display 

* @param conn the database connection 


for (Throwable t : ex) 
t.printStackTrace() ; 


} 
Pi 


JPanel buttonPanel = new JPanel (); 
add(buttonPanel, BorderLayout. SOUTH) ; 


previousButton = new JButton("Previous"); 
previousButton.addActionListener(event -> showPreviousRow()) ; 
buttonPanel .add(previousButton) ; 


nextButton = new JButton("Next"); 
nextButton.addActionListener(event -> showNextRow()); 
buttonPanel .add(nextButton) ; 


deleteButton = new JButton("Delete"); 
deleteButton.addActionListener(event -> deleteRow()); 
buttonPanel .add(deleteButton) ; 


SaveButton = new JButton("Save") ; 

saveButton.addActionListener(event -> saveChanges()); 

buttonPanel .add(saveButton) ; 

if (tableNames.getItemCount() > 0) 
showTable(tableNames.getItemAt(0), conn); 


public void showTable(String tableName, Connection conn) 


try (Statement stat = conn.createStatement() ; 
ResultSet result = stat.executeQuery("SELECT * FROM ”+ tableName)) 
{ 


// get result set 


// copy into cached row set 

RowSetFactory factory = RowSetProvider.newFactory() ; 
crs = factory.createCachedRowSet () ; 

crs, setTableName (tableName) ; 

crs.populate(result) ; 


if (scrol]Pane != null) remove(scrol] Pane) ; 
dataPanel = new DataPanel (crs); 

scrol]Pane = new JScrol]Pane(dataPanel) ; 
add(scroll Pane, BorderLayout.CENTER) ; 


pack() ; 
showNextRow() ; 


} 
catch (SQLException ex) 
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for (Throwable t : ex) 
t.printStackTrace() ; 


/** 

* Moves to the previous table row. 
村 

public void showPreviousRow() 


{ 
try 


if (crs == null || crs.isFirst()) return; 
crs.previous(); 
dataPanel . showRow(crs) ; 


} 
catch (SQLException ex) 


for (Throwable t : ex) 
t.printStackTrace() ; 


[** 

* Moves to the next table row. 
*/ 

public void showNextRow() 


{ 
try 


if (crs == null || crs.isLast()) return; 
crs.next(); 
dataPanel . showRow(crs) ; 


catch (SQLException ex) 


for (Throwable t : ex) 
t.printStackTrace() ; 


/** 
* Deletes current table row. 
* 
public void deleteRow() 
{ 
if (crs == null) return; 
new SwingWorker<Void, Void>() 
{ 
public Void doInBackground() throws SQLException 


crs.deleteRow() ; 
crs.acceptChanges (conn) ; 
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239 


if (crs.isAfterLast()) 
if (!crs.last()) crs = null; 
return null; 


} 
public void done() 
{ 


dataPanel . showRow(crs) ; 


} 


} execute(); 


} 


ae 


* Saves all changes. 
wi 
public void saveChanges () 


{ 
if (crs == null) return; 
new SwingWorker<Void, Void>() 


public Void doInBackground() throws SQLException 
{ 
dataPanel.setRow(crs) ; 
crs.acceptChanges (conn) ; 
return null; 
} 


}.execute() ; 


} 


private void readDatabaseProperties() throws IOException 
{ 
props = new Properties(); 
try (InputStream in = Files.newInputStream(Paths.get("database.properties’))) 


props. load(in); 


String drivers = props.getProperty("jdbc.drivers") ; 
if (drivers != null) System.setProperty("jdbc.drivers", drivers); 


} 
/** 


* Gets a connection from the properties specified in the file database.properties. 
* @return the database connection 
Sf 
private Connection getConnection() throws SQLException 
{ 
String url = props.getProperty("jdbc.url"); 
String username = props.getProperty("jdbc.username’’) ; 
String password = props.getProperty("jdbc.password") ; 


return DriverManager.getConnection(url, username, password); 
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249 * This panel displays the contents of a result set. 


250 */ 


251 class DataPanel extends JPanel 


252 { 


private java.uti].List<JTextField> fields; 


[+ 
* Constructs the data panel. 
* @aram rs the result set whose contents this panel displays 


时 


public DataPanel (RowSet rs) throws SQLException 


{ 


fields = new ArrayList<>(); 

SetLayout (new GridBagLayout()) ; 

GridBagConstraints gbc = new GridBagConstraints(); 
gbc.gridwidth = 1; 

gbc.gridheight = 1; 


ResultSetMetaData rsmd = rs.getMetaData() ; 
for (int 1 = 1; 1 <= rsmd.getColumnCount(); i++) 


{ 


/** 


* Shows a database row by populating all text fields with the column values. 


ji 


gbc.gridy = 1 - 1; 


String columnName = rsmd.getColumnLabel (i); 
gbc.gridx = 0; 

gbc.anchor = GridBagConstraints. EAST; 
add(new JLabel(columnName), gbc); 


int columnWidth = rsmd.getColumnDisplaySize(i); 

JTextField tb = new JTextField(columnwidth) ; 

if (!rsmd.getColumnC] assName(i) .equals("java.lang.String")) 
th.setEditable(false) ; 


fields.add(tb) ; 
gbc.gridx = 1; 


gbc.anchor = GridBagConstraints.WEST; 
add(tb, gbc); 


public void showRow(ResultSet rs) 


{ 


try 


if (rs == null) return; 
for (int 1 = 1; 1 <= fields.size(); i++) 


String field = rs == null ? "" ; rs.getString(i); 
JTextField tb = fields.get(i - 1); 
tb.setText (field); 
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303 } 

304 

305 catch (SQLException ex) 

306 

307 for (Throwable t : ex) 

308 t.printStackTrace() ; 

309 } 

310 } 

311 

32  /** 

313 * Updates changed data into the current row of the row set. 
314 */ 

315 public void setRow(RowSet rs) throws SQLException 
316 { 

317 for (int i = 1; 1 <= fields.size(); i++) 
318 { 

319 String field = rs.getString(1); 

320 JTextField tb = fields.get(i - 1); 

321 if (!field.equals(tb.getText())) 

322 rs.updateString(i, tb.getText()); 
323 } 

324 rs.updateRow() ; 

35  } 

326 } 


顶部 的 组 合 框 用 于 显示 数据 库 中 的 所 有 表 。 选 “顺和 


中 其 中 一 个 表 ， 框 中 央 就 会 显示 出 该 表 的 所 有 字段 i ee Se 


名 及 其 第 一 条 记录 的 值 ， 见 图 5-6. Mi Next 和 
Previous 按钮 可 以 滚动 遍历 表 中 的 所 有 记录 ， 还 
可 以 删除 一 行 或 编辑 行 的 值 ， 点 击 Save 按钮 可 以 将 Ly 

各 种 修改 保存 到 数据 库 中 。 图 5-6 ViewDB 应 用 程序 


注意 : 许多 数据 库 都 配 有 非常 成 熟 的 工具 ， 用 于 查看 和 编辑 数据 库 表 。 如 果 你 使 用 的 
数据 库 没有 这 样 的 工具 ， 那 么 可 以 求助 于 iSQL-Viewer ( http://isql.sourceforge.net) 或 者 
SQuirreL ( http://squirrel-sql.sourceforge.net)。 这 两 个 工具 可 以 查看 任何 JDBC 数据 库 中 
的 表 。 我 们 编写 示例 程序 并 非 为 了 取代 这 些 工 具 ， 而 是 为 了 向 你 演示 如 何 编写 工具 来 处 
理 任 意 的 数据 库 表 。 








e DatabaseMetaData getMetaData( ) 
返回 一 个 DatabaseMetaData 对 象 ， 该 对 象 封装 了 有 关 数 据 库 连接 的 元 数据 。 





e ResultSet getTables(String catalog, String schemaPattern, String 


tableNamePattern, String types[]) 


化 
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返回 某 个 目录 (catalog) 中 所 有 表 的 描述 ， 该 目录 必须 匹配 给 定 的 模式 〈schema)、 表 
名 字模 式 以 及 类 型 标准 。( 模 式 用 于 描述 一 组 相关 的 表 和 访问 权限 ， 而 目录 描述 的 是 一 
组 相关 的 模式 ， 这 些 概念 对 组 织 大 型 数据 库 非 常 重要 。) 

catalog 和 schema 参数 可 以 为 "， 用 于 检索 那些 没有 目录 或 模式 的 表 。 如 果 不 想 考 
虑 目录 和 模式 ， 也 可 以 将 上 述 参 数 设 为 null。 

types 数组 包含 了 所 需 的 表 类 型 的 名 称 ， 通 常 表 类 型 有 TABLE、VIEW、SYSTEM 
TABLE. GLOBAL TEMPORARY, LOCAL TEMPORARY, ALIAS 和 SYNONYM。 如 果 types 
为 nu11， 则 返回 所 有 类 型 的 表 。 

返回 的 结果 集 共 有 5 列 ， 均 为 String 类 型 。 

T Bm 解释 


l TABLE_CAT # Ase (可 以 为 null) 
2 TABLE_SCHEM 表 模 式 ( 可 以 为 nu11) 
3 TABLE_NAME 表 名 称 
4 TABLE_TYPE 表 类 型 


5 REMARKS 关于 表 的 注释 
e int getJDBCMajorVersion() 1.4 
e int getJDBCMinorVersion() 1.4 
返回 建立 数据 库 连 接 的 JDBC 驱动 程序 的 主 版 本 号 和 次 版 本 号 。 例 如 ， 一 个 JDBC 3.0 
的 驱动 程序 有 一 个 主 版 本 号 3 和 一 个 次 版 本 号 0。 
e int getMaxConnections() 
返回 可 同时 连接 到 数据 库 的 最 大 并 发 连接 数 。 
e int getMaxStatements( ) 
返回 单个 数据 库 连 接 允 许 同时 打开 的 最 大 并 发 语句 数 。 如 果 对 允许 打开 的 语句 数目 没 
有 限制 或 者 不 可 知 ， 则 返回 0。 






e ResultSetMetaData getMetaData( ) 
返回 与 当前 ResultSet 对 象 中 的 列 相 关 的 元 数据 。 





e int getColumnCount( ) 
返回 当前 ResultSet 对 象 中 的 列 数 。 

e int getColumnDisplaySize(int column) 
返回 给 定 列 序号 的 列 的 最 大 宽度 。 
参数 : column č 列 序号 

e String getColumnLabel(int column) 
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返回 该 列 所 建议 的 名 称 。 

参数 : column č 列 序号 
e String getColumnName(int column) 
返回 指定 的 列 序号 所 对 应 的 列 名 。 

参数 : column Fi FF 


59 事务 


我 们 可 以 将 一 组 语句 构建 成 一 个 事务 (transaction)。 当 所 有 语句 都 顺利 执行 之 后 ， 事 务 
可 以 被 提交 (commit)。 否 则 ， 如 果 其 中 某 个 语句 遇 到 错误 ， 那 么 事务 将 被 回 深 ， 就 好 像 没 有 
任何 语句 被 执行 过 一 样 。 

将 多 个 语句 组 合成 事务 的 主要 原因 是 为 了 确保 数据 库 完整 性 ( database integrity)。 例 如 ， 
假设 我 们 需要 将 钱 从 一 个 银行 账号 转移 到 另 一 个 账号 。 此 时 ， 一 个 非常 重要 的 问题 就 是 我 们 
必须 同时 将 钱 从 一 个 账号 取出 并 且 存 人 另 一 个 账号 。 如 果 在 将 钱 存 人 其 他 账号 之 前 系统 发 生 
月 演 ， 那 么 我 们 必须 撤销 取款 操作 。 

如 果 将 更 新 语句 组 合成 一 个 事务 ， 那 么 事务 要 么 成 功 地 执行 所 有 操作 并 提交 ， 要 么 在 中 
间 茶 个 位 置 发 生 失 败 。 在 这 种 情况 下 ， 可 以 执行 回 滚 (rollback) 操作 ， 则 数据 库 将 自动 撤销 
上 次 提交 事务 以 来 的 所 有 更 新 操作 产生 的 影响 。 


5.9.1 FA JDBC 对 事务 编程 


默认 情况 下 ， 数 据 库 连 接 处 于 自动 提交 模式 (autocommit mode)。 每 个 SQL 语句 一 旦 被 
执行 便 被 提交 给 数据 库 。 一 旦 命令 被 提交 ， 就 无 法 对 它 进行 回 滚 操作 。 在 使 用 事务 时 ， 需 要 
关闭 这 个 默认 值 : 

conn. setAutoCommi t (fal se) ; 

现在 可 以 使 用 通常 的 方法 创建 一 个 语句 对 象 

Statement stat = conn.createStatement(); 
然后 任意 多 次 地 调用 executeUpdate 方法 : 


Stat executeUpdate (command); 
stat. executeUpdate (command) ; 
stat. executeUpdate (commands) ; 


如 果 执 行 了 所 有 命令 之 后 没有 出 错 ， 则 调用 commit 方法 : 
conn.commit(; 
如 果 出 现 错误 ， 则 调用 : 


conn.rollbackQ); 
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此 时 ， 程 序 将 自动 撤销 自 上 次 提交 以 来 的 所 有 语句 。 当 事务 被 SQLException 异常 中 断 时 ， 
典型 的 办 法 就 是 发 起 回 滚 操作 。 


5.9.2 保存 点 


在 使 用 某 些 驱动 程序 时 ， 使 用 保存 点 (save point) 可 以 更 细 粒 度 地 控制 回 滚 操作 。 创 建 
一 个 保存 点 意味 着 稍 后 只 需 返回 到 这 个 点 ， 而 非 事 务 的 开头 。 例 如 ， 


Statement stat = conn.createStatement(); // start transaction; rollback() goes here 
stat. executeUpdate (command1) ; 

Savepoint svpt = conn.setSavepoint(); // set savepoint; rollback(svpt) goes here 
Stat.executeUpdate (command?) ; 


if (. . .) conn.rollback(svpt); // undo effect of command2 
conn. commit () 
当 不 再 需要 保存 点 时 ， 必 须 释 放 它 : 


conn. releaseSavepoint (svpt) ; 


5.9.3 ”批量 更 新 


假设 有 一 个 程序 需要 执行 许多 INSERT 语句 ， 以 便 将 数据 填 人 数据 库 表 中 ， 此 时 可 以 使 
用 批量 更 新 的 方法 来 提高 程序 性 能 。 在 使 用 批量 更 新 (batch update) 时 ,一 个 语句 序列 作为 
一 批 操 作 将 同时 被 收集 和 提交 。 


注意 : 使 用 DatabaseMetaData 接口 中 的 supportsBatchUpdates 方法 可 以 获知 数据 
库 是 否 支持 这 种 特性 。 


处 于 同一 批 中 的 语句 可 以 是 INSERT, UPDATE 和 DELETE 等 操作 ， 也 可 以 是 数据 库 定 义 
语句 ， 如 CREATE TABLE 和 DROP TABLE。 但 是 ， 在 批量 处 理 中 添加 SELECT 语句 会 抛 出 异 
ae (从 概念 上 讲 ， 批 量 处 理 中 的 SELECT 语句 没有 意义 ， 因 为 它 会 返回 结果 集 ， 而 并 不 更 新 
数据 库 ) o 

为 了 执行 批量 处 理 ， 首 先 必须 使 用 通常 的 办 法 创建 一 个 Statement 对 象 : 


Statement stat = conn.createStatement () ; 
现在 ， 应 该 调用 addBatch 方法 ， 而 非 executeUpdate 方法 : 


String command = "CREATE TABLE..." 
stat. addBatch (command) ; 


while (. . .) 


{ 
command = "INSERT INTO. . . VALUES (" +... +55 
stat.addBatch (command) ; 


最 后 ， 提 交 整 个 批量 更 新 语句 : 
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int[] counts = stat.executeBatch() ; 


调用 executeBatch 方法 将 为 所 有 已 提交 的 语句 返回 一 个 记录 数 的 数组 。 

为 了 在 批量 模式 下 正确 地 处 理 错误 ， 必 须 将 批量 执行 的 操作 视 为 单个 事务 。 如 果 批 量 更 
新 在 执行 过 程 中 失败 ， 那 么 必须 将 它 回 滚 到 批量 操作 开始 之 前 的 状态 。 

首先 ， 关 闭 自 动 提交 模式 ， 然 后 收集 批量 操作 ， 执 行 并 提交 该 操作 ， 最 后 恢复 最 初 的 自 
动 提交 模式 : 


boolean autoCommit = conn.getAutoCommit(); 
conn. setAutoCommit (fal se) ; 
Statement stat = conn.getStatement() ; 


// keep calling stat.addBatch(. . .); 
stat. executeBatch(); 


conn.commit(); 
conn. setAutoCommit (autoCommit) ; 





èe boolean getAutoCommit( ) 


e void setAutoCommit(boolean b) 
获取 该 连接 中 的 自动 提交 模式 ， 或 将 其 设置 为 b。 如 果 自 动 更 新 为 true， 那 么 所 有 语 
句 将 在 执行 结束 后 立刻 被 提交 。 
e void commit() 
提交 自 上 次 提交 以 来 所 有 执行 过 的 语句 。 
e void rollback() 
撤销 自 上 次 提交 以 来 所 有 执行 过 的 语句 所 产生 的 影响 。 
e Savepoint setSavepoint() 1.4 
e Savepoint setSavepoint(String name) 1.4 
设置 一 个 匿名 或 具名 的 保存 点 。 
e void rollback(Savepoint svpt) 1.4 
深 到 给 定 保存 点 。 


e void releaseSavepoint(Savepoint svpt) 1.4 


释放 给 定 的 保存 点 。 





e int getSavepointId() 
获取 该 匿名 保存 点 的 ID 号 。 如 果 该 保存 点 具有 名 字 ， 则 抛 出 一 个 SQLException 


异常 。 
è String getSavepointName( ) 


获取 该 保存 点 的 名 称 。 如 果 该 对 象 为 匿名 保存 点 ， 则 抛 出 一 个 SQLException 异常 。 






添加 命令 到 该 语句 当前 的 批量 命令 中 。 
eint[] executeBatch() 1.2 
e long[] executeLargeBatch() 8 


e void addBatch(String command) 1.2 
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执行 当前 批量 更 新 中 的 所 有 命令 。 返 回 一 个 记录 数 的 数组 ， 其 中 每 一 个 元 素 都 对 应 
一 条 语句 ， 如 果 其 值 非 负 ， 则 表示 受 该 语句 影响 的 记录 总 数 ; 如 果 其 值 为 SUCCESS_ 
NO_INF0， 则 表示 该 语句 成 功 执行 了 ， 但 没有 记录 数 可 用 ; 如 果 其 值 为 EXECUTE_ 


FAILED， 则 表示 该 语句 执行 失败 了 。 





如 果 驱 动 程序 支持 批量 更 新 ， 则 返回 true 


5.10 高 级 SQL 类 型 


e boolean supportsBatchUpdates() 1.2 


O 





K 5-8 列举 了 JDBC 支持 的 SQL 数据 类 型 以 及 它们 在 Java 语言 中 对 应 的 数据 类 型 。 
表 5-8 SQL 数据 类 型 及 其 对 应 的 Java 类 型 


SQL 数据 类 型 

INTEGER or INT 

SMALLINT 

NUMERIC(m,n), DECIMAL(m,n) or DEC(m,n) 
FLOAT(n) 

REAL 

DOUBLE 

CHARACTER(n) or CHAR(n) 

VARCHAR(n), LONG VARCHAR 

BOOLEAN 

DATE 

TIME 

TIMESTAMP 
BLOB 

CLOB 

ARRAY 

ROWID : 
NCHAR(n), NVARCHAR(n), LONG NVARCHAR 
NCLOB 

SQLXML 


Java 数据 类 型 


int 


short 


java.math.BigDecimal 


double 
float 
double 
String 
String 
boolean 
java.sql 
java.sql 
java.sql 
java.sql 
java.sql 
java.sql 
java.sql 
String 
java.sql 


java.sql 


.Date 
.Time 
.Timestamp 
.Blob 
.Clob 
.Array 
.Rowld 


.NClob 
.SQLXML 





/ 
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SQL ARRAY (SQL 数组 ) 指 的 是 值 的 序列 。 例 如 ,Student 表 中 通常 都 会 有 一 个 Scores 
列 ， 这 个 列 就 应 该 是 ARRAY OF INTEGER (整数 数组 )。getArray 方法 返回 一 个 接口 类 型 为 
java.sq1.Array 的 对 象 ， 该 接口 中 有 许多 方法 可 以 用 于 获取 数组 的 值 。 

从 数据 库 中 获得 一 个 LOB 或 数组 并 不 等 于 获取 了 它 的 实际 内 容 ， 只 有 在 访问 具体 的 值 
时 它们 才 会 从 数据 库 中 被 读 取出 来 。 这 对 改善 性 能 非常 有 好 处 ， 因 为 通常 这 些 数据 的 数据 量 
都 非常 大 。 

某 些 数据 库 支 持 描 述 行 位 置 的 ROWID 值 ， 这 样 就 可 以 非常 快捷 地 获取 某 一 行 值 。JDBC 
4 引入 了 java.sq1.RowId 接口 ， 并 提供 了 用 于 在 查询 中 提供 行 ID， 以 及 从 结果 中 获取 该 
值 的 方法 。 

国家 属性 字符 串 ( NCHAR 及 其 变 体 ) 按照 本 地 字符 编码 机 制 存 储 字 符 串 ， 并 使 用 本 地 排 
序 惯例 对 这 些 字符 串 进行 排序 。JDBC 4 提供 了 方法 ， 用 于 在 查询 和 结果 中 进行 Java 的 String 
对 象 和 国家 属性 字符 串 之 间 的 双 癌 转换 。 

有 些 数 据 库 可 以 存储 用 户 自 定义 的 结构 化 类 型 。JDBC 3 提供 了 一 种 机 制 用 于 将 SQL 结 
构 化 类 型 自动 映射 成 Java 对 象 。 

有 些 数据 库 提 供用 于 XML 数据 的 本 地 存储 。JDBC 4 引入 了 SQLXML 接口 ， 它 可 以 在 
内 部 的 XML 表示 和 DOM 的 Source/Result 接口 或 二 进 制 流 之 间 起 到 中 介 作 用 。 请 查看 
SQLXML 类 的 API 文档 以 了 解 详细 信息 

我 们 不 再 更 深入 地 讨论 5 这些 高 级 SQL 类 型 了 ， 你 可 以 在 《JDBC API Tutorial and 
Reference 》 和 JDBC 4 的 规范 中 找到 更 多 有 关 这 些 主题 的 信息 。 


5.11 Web 与 企业 应 用 中 的 连接 管理 


我 们 在 前 面 几 节 中 曾经 介绍 过 ， 使 用 database.properties 文件 可 以 对 数据 库 连 接 进 
行 非 常 简单 的 设置 。 这 种 方法 适用 于 小 型 的 测试 程序 ， 但 是 不 适用 于 规模 较 大 的 应 用 。 

在 Web 或 企业 环境 中 部 署 JDBC 应 用 时 ， 数 据 库 连 接管 理 与 Java 名 字 和 目录 接口 
(INDI) 是 集成 在 一 起 的 。 遍 布 企业 的 数据 源 的 属性 可 以 存储 在 一 个 目录 中 ,采用 这 种 方式 使 
得 我 们 可 以 集中 管理 用 户 名 、 和 密码 、 数 据 库 名 和 JDBC URL. 

在 这 样 的 环境 中 ， 可 以 使 用 下 列 代 码 创 建 数据 库 连 接 : 


Context jndiContext = new InitialContext(); 
DataSource source = (DataSource) jndiContext.]ookup("java:comp/env/jdbc/corejava") ; 
Connection conn = source.getConnection(); 


请 注意 ， 我 们 不 再 使 用 DriverManager ， 而 是 使 用 INDI 服务 来 定位 数据 源 。 数 据 源 就 
是 一 个 能 够 提供 简单 的 JDBC 连接 和 更 多 高 级 服务 的 接口 ， 比 如 执行 涉及 多 个 数据 库 的 分 布 
TKS, javax.sql 标准 扩展 包 定 义 了 DataSource 接口 。 


注意 : 在 Jaa EE 的 容器 中 ， 其 至 不 必 编 程 进行 JNDI 查找 ， 只 需 在 DataSource 域 上 使 
用 Resource 注解 ， 当 加 载 应 用 时 ， 这 个 数据 源 引 用 将 被 设置 : 
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@Resource(name="jdbc/corejava") 
private DataSource source; 


当然 ， 我 们 必须 在 某 个 地 方 配置 数据 源 。 如 果 你 编写 的 数据 库 程序 将 在 Servlet Ait Piz 
行 ， 比 如 Apache Tomcat， 或 在 应 用 服务 器 中 运行 ， 比 如 GlassFish， 那 么 必须 将 数据 库 配 置 
ak (包括 JNDI 名 字 、JDBC URL、 用 户 名 和 密码 ) 放置 在 配置 文件 中 ， 或 者 在 管理 员 GUI 
中 进行 设置 。 

用 户 名 管理 和 数据 库 登 录 只 是 众多 需要 特别 关注 的 问题 之 一 。 另 一 个 重要 问题 则 涉及 建 
立 数据 库 连 接 所 需 的 开销 。 我 们 的 示例 数据 库 程序 使 用 了 两 种 策略 来 获取 数据 库 连 接 : 程序 
清单 5-3 中 的 QueryDB 程序 在 程序 的 开头 建立 了 到 数据 库 的 单个 连接 ， 并 在 程序 结尾 处 关闭 
它 ， 而 程序 清单 5-4 中 的 ViewDB 程序 在 每 次 需要 时 都 打开 一 个 新 连接 。 

但 是 ， 这 两 种 方式 都 不 令 人 满意 : 因为 数据 库 连接 是 有 限 的 资源 ， 如 有 果 用 户 要 离开 应 用 
一 段 时 间 ， 那 么 他 占用 的 连接 就 不 应 该 保持 打开 状态 ; 另 一 方面 ， 每 次 查询 都 获取 连接 并 在 
随后 关闭 它 的 代价 也 是 相当 高 的 。 

解决 上 述 问题 的 方法 是 建立 数据 库 连 接 池 ( pool)。 这 意味 着 数据 库 连 接 在 物理 上 并 未 被 
关闭 ， 而 是 保留 在 一 个 队列 中 并 被 反复 重用 。 连 接 池 是 一 种 非常 重要 的 服务 ，JDBC 规范 为 
实现 者 提供 了 用 以 实现 连接 池 服 务 的 手段 。 不 过 ，JDK 本 身 并 未 实现 这 项 服务 ， 数 据 库 供 应 
商 提 供 的 JDBC 驱动 程序 中 通常 也 不 包含 这 项 服务 。 相 反 ，Web 容器 和 应 用 服务 器 的 开发 商 
通常 会 提供 连接 池 服 务 的 实现 。 

连接 池 的 使 用 对 程序 员 来 说 是 完全 透明 的 ， 可 以 通过 获取 数据 源 并 调用 getConnection 
方法 来 得 到 连接 池 中 的 连接 。 使 用 完 连 接 后 ， 需 要 调用 close 方法 。 该 方法 并 不 在 物理 上 
关闭 连接 ， 而 只 是 告诉 连接 池 已 经 使 用 完 该 连接 。 连 接 池 通常 还 会 将 池 机 制作 用 于 预备 语 
Es 

至 此 ， 你 已 经 学 会 了 JDBC 的 基本 知识 ， 并 且 已 经 知道 如 何 实现 简单 的 数据 库 应 用 。 然 
而 ， 正 如 我 们 在 本 章 的 开头 所 强调 的 那样 ， 数 据 库 的 相关 技术 非常 复杂 ; 本 章 属 于 介绍 性 章 
节 ， 相 当 多 的 高 级 话题 已 经 超出 了 本 章 的 范围 。 如 果 要 全 面 了 解 JDBC 的 高 级 功能 ， 请 参阅 
《JDBC API Tutorial and Reference 》 或 JDBC 规范 。 

在 本 章 中 ， 我 们 学 习 了 如 何 用 Java 操作 关系 型 数据 库 。 下 一 章 将 讨论 Java 8 的 日 期 和 时 
间 库 。 








565 日 期 和 时 间 API 


A 时 间 线 A 时 区 时 间 

A 本 地 日 期 全 格式 化 和 解析 

A 日 期 调整 器 全 与 遗留 代码 的 互 操作 
A 本 地 时 间 


光阴 似 箭 ， 我 们 可 以 很 容易 地 设置 一 个 起 点 ， 然 后 向 前 和 向 后 以 秒 来 计时 。 那 为 什么 处 理 
时 间 会 如 此 之 难 呢 ? 问题 出 在 人 类 自身 上 。 如 果 我 们 只 需 告诉 对 方 :“1523793600 时 来 见 我 ， 
别 迟 到 ! ”那么 一 切 都 会 很 简单 。 但 是 我 们 希望 时 间 能 够 和 朝夕 与 季节 挂钩 ， 这 就 使 事情 变 得 
复杂 了 。Java 1.0 有 一 个 Date 类 ， 事 后 证 明 它 过 于 简单 了 ， 当 Java 1.1 引 入 Calendar 类 之 后 ， 
Date 类 中 的 大 部 分 方法 就 被 弃 用 了 。 但 是 ，Calendar 的 API 还 不 够 给 力 ， 它 的 实例 是 易 变 
的 ， 并 且 它 没有 处 理 诸如 疼 秒 这 样 的 问题 。 第 3 次 升级 很 吸引 人 ， 那 就 是 Java SE 8 中 引入 的 
java.time API， 它 修正 了 过 去 的 缺陷 ， 并 且 应 该 会 服役 相当 长 的 一 段 时 间 。 在 本 章 中 ， 你 将 
会 学 习 是 什么 使 时 间 计算 变 得 如 此 烦人 ， 以 及 日 期 和 时 间 API 是 如 何 解 决 这 些 问题 的 。 


6.1 ”时间 线 


在 历史 上 ， 基 本 的 时 间 单 位 “ 秒 ” 是 从 地 球 的 自转 中 推导 出 来 的 。 地 球 自转 一 周 需 要 24 
个 小 时 ， 即 24 x 60 x 60=86400 秒 ， 因 此 ， 看 起 来 这 好 像 只 是 一 个 有 关 如 何 精 确定 义 1 秒 的 
天 文 度量 问题 。 遗 憾 的 是 ， 地 球 有 轻微 的 颤动 ， 所 以 需要 更 加 精确 的 定义 。1967 年 ， 人 们 根 
af 133 原子 内 在 的 特性 推导 出 了 与 其 历史 定义 相 匹 配 的 秒 的 新 的 精确 定义 。 自 那 以 后 ， 原 
子 钟 网 络 就 一 直 被 当 作 官方 时 间 。 

官方 时 间 的 监护 者 们 时 常 需要 将 绝对 时 间 与 地 球 自转 进行 同步 。 首 先 ， 官 方 的 秒 需要 
稍 作 调整 ， 从 1972 EFR, BRERA “HE” o 在 理论 上 ,偶尔 也 需要 移 除 1 秒 ,但 
是 这 还 从 来 没 发 生 过 。) 这 又 是 有 关 修 改 系 统 时 间 的 话题 。 很 明显 ， 图 秒 是 个 痛 点 ,许多 计 
算 机 系统 使 用 “平滑 ”方式 来 人 为 地 在 紧邻 国 秒 之 前 让 时 间 变 慢 或 变 快 ， 以 保证 每 天 都 是 
86 400 秒 。 这 种 做 法 可 以 奏效 ， 因 为 计算 机 上 的 本 地 时 间 并 非 那么 精确 ， 而 计算 机 也 惯 于 将 
自身 时 间 与 外 部 的 时 间 服 务 进行 同步 。 

Java 的 Date 和 Time API 规范 要 求 Java 使 用 的 时 间 尺 度 为 : 

o 每 天 86 400 $F 

e 每 天 正午 与 官方 时 间 精 确 匹配 

o 在 其 他 时 间 点 上 ， 以 精确 定义 的 方式 与 官方 时 间接 近 匹 配 
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这 赋予 了 Java 很 大 的 灵活 性 ， 使 其 可 以 进行 调整 ， 以 适应 官方 时 间 未 来 的 变化 。 

在 Java 中 ，Instant 表示 时 间 线 上 的 某 个 点 。 被 称 为 “新 纪元 ”的 时 间 线 原点 被 设置 
为 穿 过 伦敦 格林 威 治 皇家 天 文 台 的 本 初子 午 线 所 处 时 区 的 1970 年 1 月 1 日 的 午夜 。 这 与 
UNIX/POSIX 时 间 中 使 用 的 惯例 相同 。 从 该 原点 开始 ， 时 间 按 照 每 天 86 400 秒 回 前 或 回回 
度量 ， 精 确 到 纳 秒 。Instant 的 值 向 回 可 追溯 10 亿 年 (Instant.MIN)。 这 对 于 表示 宇宙 
年 龄 (AY 135 亿 年 ) 来 说 还 差 得 远 ， 但 是 对 于 所 有 实际 应 用 来 说 ， 应 该 足够 了 。 毕 竟 ，10 
亿 年 前 ， 地 球 表面 还 覆盖 着 冰 层 ， 只 有 当今 植物 和 动物 的 微生物 祖先 在 繁殖 生 衍 。 最 大 的 值 
Instant .MAX 是 公元 1 000 000 000 4FAY 12 H 31 日 。 

静态 方法 调用 Instant .now( ) 会 给 出 当前 的 时 刻 。 你 可 以 按照 常用 的 方式 ， 用 equals 
和 compareTo 方法 来 比较 两 个 Instant 对 象 ， 因 此 你 可 以 将 Instant 对 象 用 作 时 间 戳 。 

为 了 得 到 两 个 时 刻 之 间 的 时 间 差 ， 可 以 使 用 静态 方法 Duration.between。 例 如 ， 下 面 
的 代码 展示 了 如 何 度量 算法 的 运行 时 间 : 


Instant start = Instant.now() ; 

runAlgorithm() ; 

Instant end = Instant.now(); 

Duration timeElapsed = Duration. between(start, end); 
long millis = timeElapsed.toMillis(); 


Duration 是 两 个 时 刻 之 间 的 时 间 量 。 你 可 以 通过 调用 toNanos, toMillis, getSeconds, 
toMinutes. toHours 和 toDays 来 获得 Duration 按照 传统 单位 度量 的 时 间 长 度 。 

Duration 对 象 的 内 部 存储 所 需 的 空间 超过 了 一 个 long 的 值 ， 因 此 秒 数 存储 在 一 个 
long 中 ， 而 纳 秒 数 存储 在 一 个 额外 的 int 中 。 如 果 想 要 让 计算 精确 到 纳 秒 级 ， 那 么 实际 上 
你 需要 整个 Duration 的 存储 内 容 ， 你 可 以 使 用 表 6-1 中 所 列 的 方法 之 一 来 处 理 。 如 采 不 要 
求 这 么 高 的 精度 ， 那 么 你 可 以 用 long 的 值 来 执行 计算 ,然后 直接 调用 toNanos, 


注意 : KA 300 年 时 间 对 应 的 纳 秒 数 才 会 溢出 long 的 范围 。 
例如 ， 如 果 想 要 检查 某 个 算法 是 否 至 少 比 另 一 个 算法 快 10 倍 ， 那 么 你 可 以 执行 如 下 的 
计算 : 


Duration timeElapsed2 = Duration.between(start2, end2); 

boolean overTenTimesFaster = 
timeElapsed.multipliedBy(10) .minus(timeElapsed2).isNegative() ; 
// Or timeElapsed.toNanos() * 10 < timeE]apsed2.toNanos () 


表 6-1 用 于 时 间 的 Instant 和 Duration 的 算术 运算 


方 法 描 $ 
plus, minus 在 当前 的 Instant 或 Duration 上 加 上 或 减 去 一 个 Duration 
plusNanos, plusMillis, plusSeconds, 在 当前 的 Instant BY Duration 上 加 上 或 减 去 给 定时 间 单 位 
minusNanos, minusMillis, minusSeconds | 的 数值 
plusMinutes, plusHours, plusDays, 在 当前 Duration 上 加 上 或 减 去 给 定时 间 单 位 的 数值 


minusMinutes, minusHours, minusDays 
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( & ) 
A OK Ho $ 
multipliedBy, dividedBy, negated 返回 由 当前 的 Duration 乘 以 或 除 以 给 定 1ong 或 -1! 而 得 到 的 
Duration。 注 意 ， 你 可 以 缩放 Duration， 但 是 不 能 缩放 Instant 
isZero, isNegative 检查 当前 的 Duration EAE 0 或 负 值 


注意 : Instant fe Duration 类 都 是 不 可 修改 的 类 ， 所 以 诸如 multip1iedBy #e minus 
这 样 的 方法 都 会 返回 一 个 新 的 实例 。 


在 程序 清单 6-1 的 示例 程序 中 ， 可 以 看 到 如 何 使 用 Instant 和 Duration 类 来 对 两 个 算 
法 计时 。 





1 package timeline; 

2 

3 Import java.time.*; 

4 import java.util.*; 

5 import java.util.stream.*; 
6 

7 

8 

9 


public class Timeline 


public static void main(String[] args) 


10 { 

11 Instant start = Instant.now(); 

12 runAlgorithm() ; 

13 Instant end = Instant.nowQ); 

14 Duration timeElapsed = Duration.between(start, end); 

15 long millis = timeElapsed.toMillisQ; 

16 System.out.printf("%d milliseconds\n", millis); 

17 

18 Instant start2 = Instant.now(); 

19 runAlgorithm2() ; 

20 Instant end2 = Instant.now(); 

21 Duration timeElapsed2 = Duration.between(start2, end2); 

22 System.out.printf("%d milliseconds\n", timeElapsed2.toMillis()); 
23 boolean overTenTimesFaster = timeElapsed.multipliedBy(10) 

24 .Minus(timeE]apsed2) .isNegative() ; 

25 System.out.printf("The first algorithm is %smore than ten times faster", 
26 overTenlimesFaster ? "" : "not "); 

27 } 

28 

29 public static void runAlgorithm() 

30 { 

31 int size = 10; 

32 List<Integer> list = new Random().ints().map(i -> i % 100). limit(size) 
33 ,boxed() collect (Collectors. toList()); 

34 Collections.sort(list); 


35 System. out.printIn(list) ; 
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38 public static void runAlgorithm2() 


40 int size = 10; 


41 List<Integer> list = new Random().ints().map(i -> 1 % 100).]imt(size) 
42 ,boxed() collect (Collectors.toList()); 

43 while (!IntStream.range(1, list.size()).al]Match( 

44 i -> list.get(i - 1).compareTo(list.get(i)) <= 0)) 

45 Collections. shuffle(list) ; 

46 System.out.printIn(]ist) ; 

47 } 

48 } 





6.2 ”本 地 时 间 


现在 ， 让 我 们 从 绝对 时 间 转 移 到 人 类 时 间 。 在 Java API 中 有 两 种 人 类 时 间 ， 本 地 日 期 / 
时 间 和 时 区 时 间 。 本 地 日 期 /时间 包 含 日 期 和 当天 的 时 间 ， 但 是 与 时 区 信息 没有 任何 关联 。 
1903 Æ 6 H 14 日 就 是 一 个 本 地 日 期 的 示例 (lambda 演算 的 发 明 者 Alonzo Church 在 这 一 天 
诞生 )。 因 为 这 个 日 期 既 没 有 当天 的 时 间 ， 也 没有 时 区 信息 ， 因 此 它 并 不 对 应 精确 的 时 刻 。 
与 之 相反 的 是 ，1969 年 7 月 16 日 09:32:00 EDT (阿波 罗 11 号 发 射 的 时 刻 ) 是 一 个 时 区 日 期 
/ 时间， 表示 的 是 时 间 线 上 的 一 个 精确 的 时 刻 。 

有 许多 计算 并 不 需要 时 区 ， 在 某 些 情况 下 ， 时 区 甚至 是 一 种 障碍 。 假 设 你 安排 每 周 
10:00 开 一 次 会 。 如 果 你 加 7 天 ( 即 7x24x60x60 秒 ) 到 最 后 一 次 会 议 的 时 区 时 间 上 ， 那 么 
你 可 能 会 碰巧 跨越 了 夏令 时 的 时 间 调 整 边 界 ， 这 次 会 议 可 能 会 早 一 小 时 或 晚 一 小 时 1 

正 是 考虑 到 这 个 原因 ，API 的 设计 者 们 推荐 程序 员 不 要 使 用 时 区 时 间 ， 除 非 确 实 想 要 表 
示 绝 对 时 间 的 实例 。 生 日 、 假 日 、 计 划 时 间 等 通常 最 好 都 表示 成 本 地 日 期 和 时 间 。 

LocalDate 是 带 有 年 、 月 、 日 的 日 期 。 为 了 构建 LocalDate 对 象 ， 可 以 使 用 now 或 of 
静态 方法 : 


LocalDate today = LocalDate.now(); // Today's date 

LocalDate alonzosBirthday = LocalDate.of(1903, 6, 14); 

alonzosBirthday = LocalDate.of(1903, Month.JUNE, 14); 
// Uses the Month enumeration 


55 UNIX 和 java.util.Date 中 使 用 的 月 从 0 开始 计算 而 年 从 1900 开始 计算 的 不 规则 
的 惯用 法 不 同 ， 你 需要 提供 通常 使 用 的 月 份 的 数字 。 或 者 ， 你 可 以 使 用 Month 枚 举 。 
K 6-2 展示 了 最 有 用 的 操作 LocalDate 对 象 的 方法 。 


表 6-2 LocalDate 的 方法 


方 法 描 述 
now, of 这 些 静 态 方法 会 构建 一 个 LocalDate， 要 么 从 当前 时 间 构 建 ， 要 么 从 
给 定 的 年 月 日 构建 
plusDays, plusWeeks, 在 当前 的 LocalDate 上 加 上 一 定量 的 天 、 星 期 、 月 或 年 


plusMonths, plusYears 


j 
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( 续 ) 
方 法 描 述 
minusDays, minusWeeks, 在 当前 的 LocalDate 上 减 去 一 定量 的 天 、 星 期 、 月 或 年 
minusMonths, minusYears 
plus, minus 加 上 或 减 去 一 个 Duration a Period 


withDayOfMonth, withDayOfYear, 返回 一 个 新 的 Loca1Date， 其 月 的 日 期 、 年 的 日 期 、 月 或 年 修改 为 给 
withMonth, withYear 定 的 值 


getDayOfMonth 获取 月 的 日 期 (在 1 到 31 之 间 ) 

getDayOfYear 获取 年 的 日 期 (在 1 到 366 之 间 ) 

getDayOfWeek 获取 星期 日 期 返回 DayOfWeek 枚 举 值 

getMonth, getMonthValue 获取 月 份 的 Month 枚 举 值 ， 或 者 是 1 ~ 12 之 间 的 数字 

getYear 获取 年 份 ， 在 -999 999 999 到 999 999 999 之 间 

until 获取 Period， 或 者 两 个 日 期 之 间 按 照 给 定 的 ChronoUnits 计算 的 数值 
isBefore, isAfter 将 当前 的 LocalDate 与 另 一 个 Loca1Date 进行 比较 

isLeapYear 如 果 当 前 是 头 年 ， 则 返回 true。 即 ， 该 年 份 能 够 被 4 整除， 但 是 不 能 


被 100 整除 ， 或 者 能 够 被 400 整除 。 该 算法 可 以 应 用 于 所 有 已 经 过 去 的 年 
份 ， 尽 管 在 历史 上 它 并 不 准确 ( 图 年 是 在 公元 前 46 年 发 明 出 来 的 ， 而 涉 
及 整除 100 和 400 的 规则 是 在 1582 年 的 公历 改革 中 引入 的 。 这 场 改 革 经 
历 了 300 年 才 被 广泛 接受 ) 


例如 ， 程 序 员 日 是 每 年 的 第 256 天 。 下 面 展 示 了 可 以 如 何 很 容易 地 计算 出 它 : 


LocalDate programmersDay = LocalDate.of(2014, 1, 1).plusDays(255); 
// September 13, but in a leap year it would be September 12 


回忆 一 下 ， 两 个 Instant 之 间 的 时 长 是 Duration， 而 用 于 本 地 日 期 的 等 价 物 是 Period, 
它 表 示 的 是 流逝 的 年 、 月 或 日 的 数量 。 可 以 调用 birthday.plus(Period.ofYears(1)) 
来 获取 下 一 年 的 生日 。 当 然 ， 也 可 以 直接 调用 birthday.plusYears(1)。 但 是 birthday. 
plus(Duration.ofDays(365)) 在 图 年 是 不 会 产生 正确 结果 的 。 

util 方法 会 产生 两 个 本 地 日 期 之 间 的 时 长 。 例 如 ， 

independenceDay.until (christmas) 
会 产生 5 个 月 21 天 的 一 段 时 长 。 这 实际 上 并 不 是 很 有 用 ， 因 为 每 个 月 的 天 数 不 尽 相同 。 为 
了 确定 到 底 有 多 少 天 ， 可 以 使 用 : 

independenceDay ,unti1(christmas，ChronoUnit,DAY9) // 174 days 
O BE: £62 中 的 有 些 方法 可 能 会 创建 出 并 不 存在 的 日 期 。 例如， 在 1 月 31 日 上 加 上 1 个 月 

不 应 该 产生 2 月 31 日。 这些 方法 并 不 会 抛 出 异常 ， 而 是 会 返回 该 月 有 效 的 最 后 一 天 。 例 如 ， 

LocalDate.of(2016, 1, 31).plusMonths(1) 

和 

LocalDate.of(2016, 3, 31).minusMonths(1) 

都 将 产生 2016 #2 A 29 8. 
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getDayOfWeek 会 产生 星期 日 期 ， 即 DayOfWeek 枚 举 的 其 个 值 。DayOfWeek .MONDAY 


的 枚 举 值 为 1， 而 Day0fWeek .SUNDAY 的 枚 举 值 为 7。 例 如 ， 


LocalDate,of(1900，1，1) ,getDay0fWeek() .getValue() 


会 产生 1, DayOfWeek 枚 举 具有 便捷 方法 plus 和 minus， 以 7 为 模 计算 星期 日 期 。 例 如 ， 
Day0fWeek . SATURDAY .plus(3) 会 产生 Day0fWeek . TUESDAY, 


注意 : 周末 实际 上 在 每 周 的 末尾 。 这 与 java.uti1.Calendar 有 所 差异 ， 在 后 者 中 ， 


wee ee a E pag NT V 
T 7. * À 5 - ae. ot ENE 
by yr Fh my 


星期 六 的 值 为 1， 而 星期 天 的 值 为 7。 


除了 LocalDate 之 外 ,还 有 MonthDay, YearMonth Ail Year 类 可 以 描述 部 分 日 期 。 例 
12 月 25 日 (没有 指定 年 份 ) 可 以 表示 成 一 个 MonthDay 对 象 。 
程序 清单 6-2 中 的 示例 程序 展示 了 如 何 使 用 Loca1Date 类 。 


epee Ps Rigs Satie E paz 





1 package localdates; 
2 

3 import java.time.*: 
4 import java.time.temporal.*; 
5 

6 public class LocalDates 


7 { 

8 public static void main(String[] args) 

9 f 

10 LocalDate today = LocalDate.now(); // Today’s date 

11 System.out.printIn("today: ”+ today); 

12 

13 LocalDate alonzosBirthday = LocalDate.of(1903, 6, 14); 

14 alonzosBirthday = LocalDate.of(1903, Month.JUNE, 14); 

15 // Uses the Month enumeration 

16 System.out.println("alonzosBirthday: " + alonzosBirthday) ; 

17 

18 LocalDate programmersDay = LocalDate.of(2018, 1, 1).plusDays(255); 

19 // September 13, but in a leap year it would be September 12 

20 System.out.print]n("programmersDay: ”+ programmersDay) ; 

21 

22 LocalDate independenceDay = LocalDate.of(2018, Month. JULY, 4); 

23 LocalDate christmas = LocalDate.of(2018, Month.DECEMBER, 25); 

24 

25 System.out.printin("Until christmas: " + independenceDay.until (christmas)) ; 
26 System.out.printin("Until christmas: " 

27 + independenceDay.until (christmas, ChronoUnit.DAYS)); 

28 

29 System. out.printIn(LocalDate.of(2016, 1, 31).plusMonths(1)); 

30 System. out.printIn(LocalDate.of(2016, 3, 31).minusMonths(1)): 

31 

32 DayOfWeek startOfLastMillennium = LocalDate.of(1900, 1, 1).getDayOfWeek(); 
33 System.out.printin("start0fLastMillennium: " + startOfLastMillennium) ; 


34 System.out.println(startOfLastMillennium. getValue()); 
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35 System. out.print]n(DayOfWeek, SATURDAY. plus (3)) ; 
36 } 
37 } 


6.3 日 期 调整 如 


对 于 日 程 安排 应 用 来 说 ， 经 常 需要 计算 诸如 “每 个 月 的 第 一 个 星期 二 ”这 样 的 日 期 。 
TemporalAdjusters 类 提供 了 大 量 用 于 常见 调整 的 静态 方法 。 你 可 以 将 调整 方法 的 结果 传 
A with 方法 。 例 如 ， 某 个 月 的 第 一 个 星期 二 可 以 像 下 面 这 样 计算 : 


LocalDate firstTuesday = LocalDate.of(year, month, 1).with( 
Temporal Adjusters .nextOrSame (DayOfWeek. TUESDAY)) ; 


一 如 既往 , with 方法 会 返回 一 个 新 的 LocalDate 对 象 ， 而 不 会 修改 原来 的 对 象 。 表 6-3 
展示 了 可 用 的 调整 器 。 


表 6-3 TemporalAdjusters 类 中 的 日 期 调整 器 


方 法 fi 述 
next(weekday)，previous(weekday ) 下 一 个 或 上 一 个 给 定 的 星期 日 期 
nextOrSame(weekday), previousOrSame(weekday) | 从 给 定 的 日 期 开始 的 下 一 个 或 上 一 个 给 定 的 星期 日 期 
dayOfWeekInMonth(n, weekday) 月 份 中 的 第 nm 个 weekday 
lastInMonth(weekday ) 月 份 中 的 最 后 一 个 weekday 
firstDayOfMonth(), firstDayOfNextMonth(), 方法 名 所 描述 的 日 期 


firstDayOfNextYear(), lastDayOfMonth(), 
lastDayOfYear( ) 


还 可 以 通过 实现 TemporalAdjuster 接口 来 创建 自己 的 调整 项。 下 面 是 用 于 计算 下 一 
个 工作 日 的 调整 句 。 


TemporalAdjuster NEXT_WORKDAY = W -> 
{ 


LocalDate result = (LocalDate) w; 
do 


{ 
result = result.plusDays(1); 


} 
while (result.getDayOfWeek() .getValue() >= 6); 
return result; 


5 
LocalDate backToWork = today.with(NEXT_WORKDAY) ; 


注意 ，lambda 表达 式 的 参数 类 型 为 Temporal1， 它 必须 被 强制 转型 为 LocalDate。 你 
可 以 用 ofDateAdjuster 方法 来 避免 这 种 强制 转型 ， 该 方法 期 望 得 到 的 参数 是 类 型 为 
UnaryOperator<LocalDate> 的 lambda 表达 式 。 
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TemporalAdjuster NEXT_WORKDAY = TemporalAdjusters.ofDateAdjuster(w -> 


LocalDate result = w; // No cast 
do 


{ 
result = result.plusDays(1); 


} 
while (result.getDayOfWeek().getValue() >= 6); 
return result; 


Hs 


6.4 本 地 时 间 


LocalTime 表示 当日 时 刻 ， 例 如 1$:30:00。 可 以 用 now 或 of 方法 创建 其 实例 . 


LocalTime rightNow = LocalTime.now() ; 
LocalTime bedtime = LocalTime.of(22, 30); // or LocalTime.of(22, 30, 0) 


表 6-4 FRAN T Æ LAST ASH AY BRE. plus 和 minus 操作 是 按照 一 天 24 小 时 循环 操 
作 的。 例如 ， 


LocalTime wakeup = bedtime.plusHours(8); // wakeup is 6:30:00 


注意 : LocalTime 自身 并 不 关心 AM/PM., ZA RAAHAA A RARR, 
请 参见 6.6 节 。 


表 6-4 LocalTime 的 方法 


A 法 描 述 

now, of 这 些 静 态 方 法 会 构建 一 个 Loca1Time， 要 么 从 当前 时 间 构 建 ， 
要 么 从 给 定 的 小 时 和 分 钟 ， 以 及 可 选 的 秒 和 纳 秒 构建 

plusHours, plusMinutes, 在 当前 的 LocalTime 上 加 上 一 定量 的 小 时 、 分 钟 、 秒 或 纳 秒 
plusSeconds, plusNanos 
minusHours, minusMinutes, 在 当前 的 LocalTime 上 减 去 一 定量 的 小 时 、 分 钟 、 秒 或 纳 秒 
minusSeconds, minusNanos 
plus, minus 加 上 或 减 去 一 个 Duration 
withHour, withMinute, withSecond, 返回 一 个 新 的 Loca1Time， 其 小 时 、 分 钟 、 秒 和 纳 秒 修改 为 给 
withNano 定 的 值 
getHour, getMinute, getSecond, 获取 当前 LocalTime 的 小 时 、 分 钟 、 秒 或 纳 秒 
getNano 
toSecondOfDay, toNanoOfDay 返回 午夜 到 当前 LocalTime 的 秒 或 纳 秒 的 数量 
isBefore, isAfter 将 当前 的 LocalTime 与 另 一 个 Loca1Time 进行 比较 


还 有 一 个 表示 日 期 和 时 间 的 LocalDateTime 类 。 这 个 类 适合 存储 固定 时 区 的 时 间 点 ， 
例如 ， 用 于 排 课 或 排 程 。 但 是 ， 如 果 你 的 计算 需要 跨越 夏令 时 ， 或 者 需要 处 理 不 同时 区 的 用 
户 ， 那 么 就 应 该 使 用 接 下 来 要 讨论 的 ZonedDateTime 类 。 
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6.5 时 区 时 间 


时 区 ， 可 能 是 因为 完全 是 人 为 创造 的 原因 ， 它 们 甚至 比 地 球 不 规则 的 转动 引发 的 复杂 性 
还 要 麻烦 。 在 理性 的 世界 中 ， 我 们 都 会 遵循 格林 尼 治 时 间 ， 有 些 人 在 02:00 吃 午饭 ， 而 有 些 
人 却 在 22:00 吃 午饭 。 我 们 的 胃 能 弄 明 白 这 是 怎么 回 事 。 这 就 是 中 国 的 做 法 ， 中 国 横 跨 了 4 
个 时 区 ， 但 是 使 用 了 同一 个 时 间 。 在 其 他 地 方 ， 时 区 显得 并 不 规则 ， 并 且 还 有 国际 日 期 变更 
线 ， 而 夏令 时 则 使 事情 变 得 更 糟 了 。 

尽管 时 区 显得 变化 繁多 ， 但 这 就 是 无 法 回避 的 现实 生活 。 在 实现 日 历 应 用 时 ， 它 需要 能 
够 为 坐 飞机 在 不 同 国家 之 间 穿 梭 的 人 们 提供 服务 。 如 果 你 有 个 10:00 在 纽约 召开 的 电话 会 议 ， 
但 是 碰巧 你 人 在 柏林 ， 那 么 你 肯定 希望 该 应 用 能 够 在 正确 的 本 地 时 间 点 上 发 出 提醒 。 

互联 网 编码 分 配 管理 机 构 (Internet Assigned Numbers Authority, IANA) 保存 着 一 个 数据 
库 ， 里 面 存储 着 世界 上 所 有 已 知 的 时 区 (www.iana.org/time-zones)， 它 每 年 会 更 新 数 次 ， 而 
批量 更 新 会 处 理 夏令 时 的 变更 规则 。jJava 使 用 了 IANA 数据 库 。 

每 个 时 区 都 有 一 个 ID， 例 如 America/New_York 和 Europe/Ber1in。 要 想 找 出 所 有 可 
用 的 时 区 ， 可 以 调用 ZoneId.getAvailableZoneIds。 在 本 书 撰写 之 时 ， 有 将 近 600 ID. 

给 定 一 个 时 区 ID ， 静 态 方法 ZoneId.of(id) 可 以 产生 一 个 ZoneId 对 象 。 可 以 通过 调 
用 1oca1.atzone(zoneId) 用 这 个 对 象 将 LocalDateTime 对 象 转换 为 ZonedDateTime 对 
象 ， 或 者 可 以 通过 调用 静态 方法 ZonedDateTime.of(year ,month ,day,hour ,minute ,se 
cond,nano, zoneld) 来 构造 一 个 ZonedDateTime 对 象 。 例 如 ， 


ZonedDateTime apollolllaunch = ZonedDateTime.of(1969, 7, 16, 9, 32, 0, 0, 
Zoneld.of ("America/New_York")); 
// 1969-07-16T09: 32-04:00 [Ameri ca/New_York] 


这 是 一 个 具体 的 时 刻 ， 调 用 apollolllaunch.toInstant 可 以 获得 对 应 的 Instant 对 象 。 反 
过 来 ， 如 果 你 有 一 个 时 刻 对 象 ， 调 用 instant .atZone(ZoneId.of("UTC") ) 可 以 获得 格林 威 治 皇 
家 天 文 台 的 ZonedDateTime 对 象 ， 或 者 使 用 其 他 的 ZoneId 获得 地 球 上 其 他 地 方 的 ZoneId。 


注意 : UTC 代表 “协调 世界 时 " ， 这 是 英文 “Coordinated Universal Time” 4°74 X “Temps 
Universel Coordiné” 首 字母 缩写 的 折 中 ， 它 与 这 两 种 语言 中 的 缩写 都 不 一 致 。UTC 是 不 
考虑 夏令 时 的 格林 威 治 皇 家 天 文 台 时 间 。 
ZonedDateTime 的 许多 方法 都 与 Loca1DateTime 的 方法 相同 (参见 表 6-5 )， 它 们 大 多 
数 都 很 直接 ， 但 是 夏令 时 带 来 了 一 些 复杂 性 。 
表 6-5 ZonedDateTime 的 方法 


J È Ho R 
now, of, ofInstant 构建 一 个 ZonedDateTime， 要 么 从 当前 时 间 构 建 ， 
要 么 从 一 个 LocalDateTime、 一 个 LocalDate、 与 


Zoneld 一 起 的 年 /月 /日 /分 钟 / 秒 / 纳 秒 ， 或 从 一 个 
Instant 和 ZoneId 中 创建 。 这 些 都 是 静态 方法 





方法 


plusDays, plusWeeks, plusMonths, plusYears, 


plusHours, plusMinutes, plusSeconds, 
plusNanos 


minusDays, minusWeeks, minusMonths, 
minusYears, minusHours, minusMinutes, 
minusSeconds, minusNanos 


plus, minus 


withDayOfMonth, withDayOfYear, withMonth, 
withYear, withHour, withMinute, withSecond 
withNano 


withZoneSameInstant, withZoneSameLocal 


getDayOfMonth 

getDayOfYear 

getDayOfWeek 

getMonth, getMonthValue 

getYear 

getHour, getMinute, getSecond, getNano 
getOffset 


toLocalDate, toLocalTime, toInstant 


isBefore, isAfter 
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( 续 ) 
描述 
在 当前 的 ZonedDateTime 上 加 上 一 定量 的 时 间 单 位 


在 当前 的 ZonedDateTime 上 减 去 一 定量 的 时 间 单 位 


加 上 或 减 去 一 个 Duration 或 Period 
返回 一 个 新 的 ZonedDateTime， 其 某 个 时 间 单 位 被 修 


,| 改 为 给 定 的 值 


返回 一 个 给 定时 区 的 新 的 ZonedDateTime， 要 么 表示 


同一 个 时 刻 ， 要 么 表示 同一 个 本 地 时 间 


获取 月 的 日 期 (在 1 ~ 31 之 间 ) 

获取 年 的 日 期 (在 1 ~ 366 之 间 ) 

获取 星期 日 期 ， 返 回 DayOfWeek 枚 举 的 某 个 值 

获取 月 份 的 Month 枚 举 值 , 或 者 在 1 ~ 12 之 间 的 数字 
获取 年 份 ， 在 -999 999 999 ~ 999 999 999 之 间 

获取 当前 的 ZonedDateTime 的 小 时 、 分 钟 、 秒 和 纳 秒 
获取 作为 zone0ffset 实例 的 距离 UTC Hate. ti 


移 量 在 -12:00 ~ +14:00 之 间 变 化 。 有 些 时 区 有 小 数 偏 移 
量 。 偏 移 量 会 随 夏令 时 而 发 生变 化 


产生 本 地 日 期 或 本 地 时 间 ， 或 者 对 应 的 Instant 对 象 
将 当前 的 ZonedDateTime 与 另 一 个 ZonedDateTime 


进行 比较 


当 夏 令 时 开始 时 ， 时 钟 要 向 前 拨 快 一 小 时 。 当 你 构建 的 时 间 对 象 正好 落 入 了 这 上 跳 过 去 的 
一 个 小 时 内 时 ， 会 发 生 什么 ?” 例 如， 在 2013 年 ， 中 欧 地 区 在 3 月 31 日 2:00 切换 到 夏令 时 ， 


如 果 你 试图 构建 的 时 间 是 不 存在 的 3 月 31 A 2:30, 那么 你 实际 上 得 到 的 是 3:30。 


ZonedDateTime skipped = ZonedDateTime. of ( 
LocalDate.of(2013, 3, 31), 
LocalTime.of(2, 30), 
Zoneld.of("Europe/Berlin")) ; 

// Constructs March 31 3:30 


反 过 来 ， 当 夏令 时 结束 时 ， 时 钟 要 向 回 拨 慢 一 小 时 ， 这 样 同 一 个 本 地 时 间 就 会 有 出 现 两 


次 。 当 你 构建 位 于 这 个 时 间 段 内 的 时 间 对 象 时 ， 就 会 得 到 这 两 个 时 刻 中 较 早 的 一 个 : 


ZonedDateTime ambiguous = ZonedDateTime ,of( 


LocalDate.of(2013, 10, 27), // End of daylight savings time 


LocalTime.of(2, 30), 

ZonelId.of("Europe/Berlin")); 

// 2013-10-27T02:30+02:00[Europe/Berlin] 
ZonedDateTime anHourLater = ambiguous.plusHours(1) ; 

// 2013-10-27T02: 30+01:00[Europe/Berlin] 
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一 个 小 时 后 的 时 间 会 具有 相同 的 小 时 和 分 钟 ， 但 是 时 区 的 偏 移 量 会 发 生变 化 。 
你 还 需要 在 调整 跨越 夏令 时 边界 的 日 期 时 特别 注意 。 例 如 ， 如 果 你 将 会 议 设置 在 下 个 星 
期 ,不 要 直接 加 上 一 个 7 天 的 Duration: 


ZonedDateTime nextMeeting = meeting.plus(Duration.ofDays(7)); 
// Caution! Won't work with daylight savings time 


而 是 应 该 使 用 Period 类 。 


ZonedDateTime nextMeeting = meeting.plus(Period.ofDays(7)); // OK 


@ 警告 : 还 有 一 个 0ffsetDateTime 类 ， 它 表示 与 UTC 具有 偏 移 量 的 时 间 ， 但 是 没有 时 
区 规则 的 束缚 。 这 个 类 被 设计 用 于 专用 应 用 ， 这 些 应 用 特别 需要 剔除 这 些 规 则 的 约束 ， 
例如 某 些 网 络 协议 。 对 于 人 类 时 间 ， 还 是 应 该 使 用 ZonedDateTime。 


程序 清单 6-3 中 的 示例 程序 演示 了 ZonedDateTime 类 的 用 法 。 





1 package zonedtimes; 

2 

3 Import java.time.*; 

4 

5 public class ZonedTimes 


6 { 

7 public static void main(String[] args) 

| 

9 ZonedDateTime apollolllaunch = ZonedDateTime.of(1969, 7, 16, 9, 32, 0, 0, 
10 Zoneld.of("America/New_York")); 

11 // 1969-07-16T09:32-04:00[America/New_York] 

12 System.out.print]n("apollolllaunch: " + apollolllaunch) ; 

13 

14 Instant instant = apollolllaunch.toInstant() ; 

15 System.out.println("instant: ”+ instant); 

16 

17 ZonedDateTime zonedDateTime = instant.atZone(Zoneld.of("UTC")); 

18 System.out.println("zonedDateTime: " + zonedDateTime) ; 

19 

20 ZonedDateTime skipped = ZonedDateTime.of(LocalDate.of(2013, 3, 31), 
21 LocalTime.of(2, 30), ZoneId.of("Europe/Berlin")); 

22 // Constructs March 31 3:30 

23 System.out.printIn("skipped: " + skipped); 

24 

25 ZonedDateTime ambiguous = ZonedDateTime.of(LocalDate.of(2013, 10, 27), 
26 // End of daylight savings time 

27 LocalTime.of(2, 30), ZoneId.of("Europe/Berlin")); 

28 // 2013-10-27T02:30+02:00[Europe/Berlin] 

29 ZonedDateTime anHourLater = ambiguous .plusHours (1); 

30 // 2013-10-27T02:30+01:00[Europe/Berlin] 

31 System.out.print]n("ambiguous: ”+ ambiguous); 

32 System.out.print]n("“anHourLater: " + anHourLater); 

33 

34 ZonedDateTime meeting = ZonedDateTime.of(LocalDate.of(2013, 10, 31), 





6R AAF] API 299 


35 LocalTime.of(14, 30), ZoneId.of("America/Los_Angeles")); 
36 System.out.printIn("meeting: ”+ meeting); 

37 ZonedDateTime nextMeeting = meeting.plus(Duration.ofDays(7)) ; 
38 // Caution! Won’t work with daylight savings time 

39 System.out.printin("nextMeeting: ”+ nextMeeting) ; 

40 nextMeeting = meeting.plus(Period.ofDays(7)); // OK 

41 System.out.printIn("nextMeeting: ”+ nextMeeting) ; 

42 } 

43 } 





6.6 格式 化 和 解析 


DateTimeFormatter 类 提供 了 三 种 用 于 打印 日 期 /时 间 值 的 格式 从: 
o 预定 义 的 格式 器 ( 参见 表 6-6) 

e Locale 相关 的 格式 大 

e 带 有 定制 模式 的 格式 佣 


表 6-6 预定 义 的 格式 器 


格式 器 T A 
. AY & » Pla 


BASIC_ISO_DATE 年 、 月 、 日 、 时 区 偏 移 量 ， 中 间 没 | 19690716-0500 
有 分 隔 符 


IS0_LOCAL_DATE ， 1969-07-16, 09:32:00, 
ISO_LOCAL_TIME, 1969-07-16T09:32:00 
ISO_LOCAL_DATE_TIME 







ISO_OFFSET_DATE, 类 似 ISO_LOCAL_XXX, {HLA AY | 1969-07-16-05:00, 09:32:00-05:00, 

ISO_OFFSET_TIME, 偏 移 量 1969-07-16T09:32:00-05:00 

ISO_OFFSET_DATE_TIME 

ISO_ZONED_DATE_TIME 有 了 时 区 偏 移 量 和 时 区 ID 1969-07-16T09:32:00-05:00[America/ 
New_York] 

ISO_INSTANT 在 UTC 中 ,用 Zz 时 区 ID 来 表示 1969-07-16T14:32:00Z 





类 似 ISO_OFFSET_DATE , ISO_OFFSET_| 1969-07-16-05:00, 09:32:00-05:00, 
TIME #il ISO_ZONED_DATE_TIME, {H|1969-07-16T09: 32: 00-05: 00[America/ 
是 时 区 信息 是 可 选 的 New_York] 


ISO_ORDINAL_DATE LocalDate 的 年 和 年 日 期 1969-197 
ISO_WEEK_DATE LocalDate 的 年 、 星 期 和 星期 日 期 | 1969-wW29-3 


RFC_1123_DATE_TIME 用 于 邮件 时 间 惟 的 标准 ， 编 每 于 |Wed，,，16 Jul 1969 09:32:00 -0500 
RFC822， 并 在 RFC1123 中 将 年 份 更 
新 到 4 位 


ISO_DATE, ISO_TIME, 
ISO_DATE_TIME 







要 使 用 标准 的 格式 器 ， 可 以 直接 调用 其 format 方法 : 


String formatted = DateTimeFormatter,ISO_OFFSET_DATE_TIME. format (apol10111 aunch) ; 
// 1969-07-16T09: 32:00-04:00" 
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可 以 使 用 Locale 相关 的 格式 器 。 对 于 日 期 和 时 间 而 言 ， 有 4 种 与 Locale 相关 的 格式 化 风格 ， 
B SHORT, MEDIUM, LONG 和 FULL， 参 见 表 6-7。 


表 6-7 Locale 相关 的 格式 化 风格 








风 格 日 期 时 间 
SHORT 7/16/69 9:32 AM 
MEDIUM Jul 16, 1969 9:32:00 AM 
LONG July 16, 1969 9:32:00 AM EDT 
FULL Wednesday, July 16, 1969 9:32:00 AM EDT 





it a Jy HK ofLocalizedDate, ofLocalizedTime fil ofLocalizedDateTime 可 以 创 
建 这 种 格式 器 。 例 如 : 


DateTimeFormatter formatter = DateTimeFormatter.ofLocalizedDateTime(FormatStyle.LONG) ; 
String formatted = formatter. format (apollol1launch) ; 
// July 16, 1969 9:32:00 AM EDT 


这 些 方 法 使 用 了 默认 的 Locale。 为 了 切换 到 不 同 的 Localeg， 可 以 直接 使 用 withLocale 方法 。 


formatted = formatter.withLocale(Locale. FRENCH) . format (apollo11launch) ; 
// 16 juillet 1969 09:32:00 EDT 


DayOfWeek 和 Month 枚 举 都 有 getDisplayName 方法 ， 可 以 按照 不 同 的 Locale 和 格式 
给 出 星期 日 期 和 月 份 的 名 字 。 


for (Day0fWeek w : DayOfWeek.values()) 
System. out.print(w.getDisplayName(TextStyle.SHORT, Locale. ENGLISH) + " "): 
// Prints Mon Tue Wed Thu Fri Sat Sun 


请 查看 第 T 章 以 了 解 更 多 有 关 Locale 的 信息 。 
注意 : java.time.format.DateTimeFormatter 类 被 设计 用 来 替代 java.util.DateFormat. 
如 果 你 为 了 向 后 兼容 性 而 需要 后 者 的 示例 ， 那 么 可 以 调用 formatter.toFormat(), 
最 后 ， 可 以 通过 指定 模式 来 定制 自己 的 日 期 格式 。 例 如 ， 
formatter = DateTimeFormatter.ofPattern("E yyyy-MM-dd HH:mm") ; 
会 将 日 期 格式 化 为 Wed 1969-07-16 09:32 HJER. JE TISE H GE HERE AR TE 
的 规则 ， 每 个 字母 都 表示 一 个 不 同 的 时 间 域 ， 而 字母 重复 的 次 数 对 应 于 所 选择 的 特定 格式 。 
表 6-8 展示 了 最 有 用 的 模式 元 素 。 
表 6-8 常用 的 日 期 /时间 格式 的 格式 化 符号 


时 间 域 或 目的 示 A 
ERA G: AD, GGGG: Anno Domini, GGGGG: A 
YEAR_OF_ERA yy: 69, yyyy: 1969 
MONTH_OF_YEAR M: 7, MM: 07, MMM: Jul, MMMM: July, MMMMM: J 





化 音 IT 
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( 2 ) 
时 间 域 或 目的 T A 
DAY_OF_MONTH d: 6, dd: 06 
DAY_OF_WEEK e: 3, E: Wed, EEEE: Wednesday, EEEEE: W 
HOUR_OF_DAY H: 9, HH: 09 
CLOCK_HOUR_OF_AM_PM K: 9, KK: 09 
AMPM_OF_DAY a: AM 
MINUTE_OF_HOUR mm: 02 
SECOND_OF_MINUTE ss: 00 
NANO_OF_SECOND nnnnnn: 000000 
时 区 ID VV: America/New_York 
时 区 名 z: EDT, zzzz: Eastern Daylight Time 
时 区 偏 移 量 x: -04, xx: —0400, xxx: -04:00, XXX: 45 xxx 相同 ,但 是 Z 表示 0 
本 地 化 的 时 区 偏 移 量 O: GMT-4, 0000: GMT-04:00 


为 了 解析 字符 串 中 的 日 期 /时 间 值 ， 可 以 使 用 众多 的 静态 parse 方法 之 一 。 例 如 ， 


LocalDate churchsBirthday = LocalDate.parse("1903-06-14") ; 

ZonedDateTime apollolllaunch = 

ZonedDateTime.parse("1969-07-16 03:32:00-0400", 
DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm:ssxx")); 


第 一 个 调用 使 用 了 标准 的 TSO_LLOCAL_DATE 格式 器 ， 而 第 二 个 调用 使 用 的 是 一 个 定制 的 


BRINT o 
程序 清单 6-4 中 的 程序 展示 了 如 何 格式 


ER 







化 和 解析 日 期 与 时 间 。 


ny f EER T ie La, 






package formatting; 


1 

2 

3 import java.time.*; 

4 import java.time. format. *; 
s import java.util.*; 

6 

7 public class Formatting 

s { 

9 


public static void main(String[] args) 


{ 
11 ZonedDateTime apollolllaunch = ZonedDateTime.of(1969, 7, 16, 9, 32, 0, 0, 


12 ZoneId.of("America/New_York")); 

13 

14 String formatted = DateTimeFormatter.1SO_OFFSET_DATE_TIME. format (apol 10111 aunch) ; 

15 // 1969-07-16T09: 32:00-04:00 

16 System.out.printIn(formatted) ; 

17 

18 DateTimeFormatter formatter = DateTimeFormatter.ofLocalizedDateTime(FormatStyle. LONG) ; 
19 formatted = formatter. format (apollo11]aunch) ; 

20 // July 16, 1969 9:32:00 AM EDT 

21 System. out.printIn(formatted) ; 
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22 formatted = formatter.withLocale(Locale. FRENCH) . format (apol]o11]aunch) ; 
23 // 16 juillet 1969 09:32:00 EDT 

24 System. out.print]n(formatted) ; 

25 

26 formatter = DateTimeFormatter.ofPattern("E yyyy-MM-dd HH:mm"); 

27 formatted = formatter. format (apollol1launch) ; 

28 System. out.printIn(formatted) ; 

29 

30 LocalDate churchsBirthday = LocalDate.parse("1903-06-14"); 

31 System.out.print]n("churchsBirthday: " + churchsBirthday) ; 

32 apollolllaunch = ZonedDateTime.parse("1969-07-16 03:32:00-0400", 

33 DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm:ssxx")); 

34 System.out.printIn("apollolllaunch: " + apollolllaunch) ; 

35 

36 for (DayOfWeek w : DayOfWeek.values()) 

37 System.out.print(w.getDisp]layName(TextStyle.SHORT, Locale. ENGLISH) 
38 4 " "ys 

39 } 

40 } 


6.7 与 遗留 代码 的 互 操 作 
作为 全 新 的 创造 ，Java Date 和 Time API 必须 能 够 与 已 有 类 之 间 进 行 互 操作 ， 特 别 是 无 处 不 在 


的 java.util.Date, java.util.GregorianCalendar i java.sql] .Date/Time/Timestamp, 

Instant 类 近似 于 java.uti1.Date。 在 Java SE 8 中 ， 这 个 类 有 两 个 额外 的 方法 : 将 Date 
转换 为 Instant 的 toInstant 方法 ， 以 及 反方 向 转换 的 静态 的 from 方法 。 

类 似 地 ，ZonedDateTime 近似 于 java.uti1.GregorianCcalendar ， 在 Java SE 8 中， 
这 个 类 有 细 粒 度 的 转换 方法 。toZonedDateTime 方法 可 以 将 GregorianCcalendar 转换 为 
ZonedDateTime， 而 静态 的 from 方法 可 以 执行 反方 向 的 转换 。 

另 一 个 可 用 于 日 期 和 时 间 类 的 转换 集 位 于 java.sq1 包 中 。 你 还 可 以 传递 一 个 
DateTimeFormatter 给 使 用 java.text.Format 的 遗留 代码 。 表 6-9 对 这 些 转换 进行 了 总 结 。 


表 6-9 java.time 类 与 遗留 类 之 间 的 转换 


类 转换 到 遗留 类 转换 自 遗 留 类 


Instant Date.from( instant) date.toInstant() 

ZonedDateT ime GregorianCalendar. cal .toZonedDateTime( ) 

«> java.util .GregorianCalendar 

Instant TimeStamp. from( instant) timestamp. toInstant( ) 
LocalDateTime Timestamp. valueOf(1ocalDateTime) timeStamp.toLocalDateTime( ) 
LocalDate Date. valueOf(localDate ) date .toLocalDate( ) 


华章 IT 


BOF HAA AH] API 303 


(  ) 
类 转换 到 遗留 类 转换 自 遗 留 类 


LocalTime Time. valueOf(1ocalTime) time .toLocalTime( ) 
«+ java.sql.Time 

DateTimeFormatter formatter .toFormat( ) Ie 

一 java.text.DateFormat 

java.util. TimeZone Timezone .getTimeZone(id) timeZone .toZoneld( ) 
— Zoneld 

java.nio.file.attribute.FileTime FileTime.from( instant ) fileTime.toInstant() 
— Instant 


你 现在 知道 如 何 使 用 Java 8 的 日 期 和 时 间 库 来 操作 全 世界 的 日 期 和 时 间 值 了 。 下 一 章 将 
进一步 讨论 如 何 为 国际 受众 编程 。 你 将 会 看 到 如 何以 对 客户 而 言 有 意义 的 方式 来 格式 化 程序 
的 消息 、 数 字 和 货币 ， 无 论 这 些 客户 身 处 世界 的 何 处 。 





Ble 国际 化 


A Locale XA 全 消息 格式 化 

A 数字 格式 A 文本 文件 和 字符 集 
A 日 期 和 时 间 全 资源 包 

A 排序 和 范 化 全 一 个 完整 的 例子 


世界 丰 宣 多彩， 我 们 希望 大 部 分 居民 都 能 对 你 的 软件 感 兴趣 。 一 方面 ， 因 特 网 早已 为 我 
们 打破 了 国家 之 间 的 界限 。 男 一 方面 ， 如 果 你 不 去 关注 国际 用 户 ， 你 的 产品 的 应 用 情况 就 会 
受到 限制 。 

Java 编程 语言 是 第 一 种 设计 成 为 全 面 支持 国际 化 的 语言 。 从 一 开始 ， 它 就 具备 了 进行 有 
效 的 国际 化 所 必需 的 一 个 重要 特性 : 使 用 Unicode 来 处 理 所 有 字符 串 。 支 持 Unicode 使 得 在 
Java 编程 语言 中 ， 编 写 程序 来 操作 多 种 语言 的 字符 串 变 得 异常 方便 。 

多 数 程 序 员 相信 将 他 们 的 程序 进行 国际 化 需要 做 的 所 有 事情 就 是 支持 Unicode 并 在 用 户 
接口 中 对 消息 进行 翻译 。 但 是 ， 在 本 章 你 将 会 看 到 ， 国 际 化 一 个 程序 所 要 做 的 事情 绝 不 仅仅 
是 提供 Unicode 支持 。 在 世界 的 不 同 地 方 ,， 日 期 、 时 间 、 货 币 甚至 数字 的 格式 都 不 相同 。 你 
需要 用 一 种 简单 的 方法 来 为 不 同 的 语言 配置 菜单 与 按钮 的 名 字 、 消 息 字符 串 和 快捷 键 。 

在 本 章 中 ， 我 们 将 演示 如 何 编写 国际 化 的 Java 应 用 程序 以 及 如 何 将 日 期 、 时 间 、 数 字 、 
文本 和 图 形 用 户 界 面 本 地 化 ， 还 将 演示 Java 提供 的 编写 国际 化 程序 的 工具 。 最 后 以 一 个 完整 
的 例子 来 作为 本 章 的 结束 ， 它 是 一 个 退休 金 计 算 器 ， 带 有 英语 、 德 语 和 中 文 用 户 界面 。 


7.1 Locale WR 


当 你 看 到 一 个 面向 国际 市 场 的 应 用 软件 时 ， 它 与 其 他 软件 最 明显 的 区 别 就 是 语言 。 其 实 
如 条 以 这 种 外 在 的 不 同 来 判断 是 不 是 真正 的 国际 化 就 太 片面 了 : 不 同 的 国家 可 以 使 用 相同 的 
语言 ， 但 是 为 了 使 两 个 国家 的 用 户 都 满意 ， 你 还 有 很 多 工作 要 做 。 就 像 Oscar Wilde 所 说 的 
那样 ,“ 我 们 现在 真 的 是 每 件 东 西 都 和 美国 一 样 ， 当 然 ， 语 言 除 外 ”。 

不 管 怎 样 ， 汪 单 、 按 钮 标签 和 程序 的 消息 需要 转换 成 本 地 语言 ;有 时 候 还 需要 用 不 同 的 脚 
本 来 润色 。 这 种 差别 很 细微 ; 比如 ， 数 字 在 英语 和 德语 中 格式 很 不 相同 。 对 于 德国 用 户 ， 数 字 

123,456.78 
应 该 显示 为 

123.456,78 
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小 数 点 和 十 进 制 数 的 逗号 分 隔 符 的 角色 是 相反 的 ! 在 日 期 的 显示 上 也 有 相似 的 变化 。 在 美 
国 ， 日 期 显示 为 月 /日 /年 ， 这 有 些 不 合理 。 德 国 使 用 的 是 更 合理 的 顺序 ， 即 日 /月 /年 ， 而 
在 中 国 ， 则 使 用 年 /月 / 上 日。 因此， 对 于 德国 用 户 ， 日 期 
3/22/61 
MBIA A 
22.03.1961 
当然 ， 如 果 月 份 的 名 称 被 显 式 地 写 了 出 来 ， 那 么 语言 之 间 的 不 同 就 显而易见 了 。 喘 语 
March 22, 1961 
在 德国 应 该 被 表示 成 
22. Marz 1961 


在 中 国 则 是 
1961 4 3 H 22 H 
有 若干 个 专门 负责 格式 处 理 的 类 。 为 了 对 格式 化 进行 控制 ， 可 以 使 用 Locale %, locale 
由 多 达 5 个 部 分 构成 : 
1 ) 一 种 语言 ， 由 2 个 或 3 个 小 写字 母 表示 ， 例 如 en (Ris), de (德语 ) M zh (P 
文 ) 。 表 7-1 展示 了 常用 的 代码 。 
表 7-1 常见 的 1SO-639-1 语言 代码 


语 8 代 a 语 言 代 8 
Chinese zh Italian it 
Danish da Japanese ja 
Dutch nl Korean ko 
English en Norwegian no 
French Tr Portuguese pt 
Finnish Fi Spanish es 
German de Swedish SV 
Greek el Turkish tr 


2) 可 选 的 一 段 脚 本 ， 由 首 字母 大 写 的 四 个 字母 表示 ， 例 如 Latn (MIX) Cyri (A 
里 尔 文 ) 和 Hant (繁体 中 文字 符 )。 这 个 部 分 很 有 用 ， 因 为 有 些 语言 ， 例 如 塞尔维亚 语 ， 可 
以 用 拉丁 文 或 西里 尔 文 书写 ， 而 有 些 中 文 读 者 更 喜欢 阅读 繁体 中 文 而 不 是 简体 中 文 。 

3 ) 可 选 的 一 个 国家 或 地 区 ， 由 2 个 大 写字 母 或 3 个 数字 表示 ， 例 如 US (美国 ) 和 CH 
(瑞士 )。 表 7-2 展示 了 篆 用 的 代码 。 

4) 可 选 的 一 个 变 体 ， 用 于 指定 各 种 杂项 特性 ， 例 如 方言 和 拼写 规则 。 变 体现 在 已 经 很 
少 使 用 了 。 过 去 曾经 有 一 种 挪威 语 的 变 体 “ 尼 诺 斯 克 语 ”"， 但 是 它 现 在 已 经 用 为 一 种 不 同 的 
代码 nn 来 表示 了 。 过 去 曾经 用 于 日 本 帝国 历 和 泰语 数字 的 变 体现 在 也 都 被 表示 成 了 扩展 (请 
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参见 下 一 条 )。 

5) 可 选 的 一 个 扩展 。 扩 展 描述 了 日 历 (例如 日 本 历 ) 和 数字 (替代 西方 数字 的 泰语 数字 ) 
等 内 容 的 本 地 偏好 。Unicode 标准 规范 了 其 中 的 某 些 扩 展 ， 这 些 扩展 应 该 以 u- 和 两 个 字母 代 
码 开 头 ， 这 两 个 字母 的 代码 指定 了 该 扩展 处 理 的 是 日 历 (ca) 还 是 数字 (nu), 或 者 是 其 他 内 
容 。 例 如 ， 扩 展 u-nu-thai 表示 使 用 泰语 数字 。 其 他 扩展 是 完全 任意 的 ， 并 且 以 x- 开头 ， 
例如 x-java。 


表 7-2 常见 的 1SO-3166-1 国家 代码 


语 6 K m 语 言 KK aB 
Austria AT Japan JP 
Belgium BE Korea KR 
Canada CA The Netherlands NL 
China CN Norway NO 
Denmark DK Portugal PT 
Finland FI Spain ES 
Germany DE Sweden SE 
Great Britain GB Switzerland CH 
Greece GR Taiwan TW 
Ireland IE Turkey TR 
Italy LT United States US 


locale 的 规则 在 Internet Engineering Task Force 的 “Best Current Practices ”备忘录 
BCP47 (http://tools.ietf.org/html/bep47 ) 进行 了 明确 阐述 。 你 可 以 在 www.w3.org/International/ 
articles/language-tags 处 找到 更 容易 理解 的 总 结 。 

语言 和 国家 的 代码 看 起 来 有 点 乱 ， 因 为 它们 中 的 有 些 是 从 本 地 语言 导出 的 。 德 语 在 德语 
中 是 Deutsch， 中 文 在 中 文 里 是 zhongwen， 因 此 它们 分 别 是 de 和 zh。 瑞士 是 CH， 这 是 从 瑞 
士 联邦 的 拉丁 语 Confoederatio Helvetica 中 导出 的 。 

locale 是 用 标签 描述 的 ， 标 签 是 由 locale 的 各 个 元 素 通过 连 字 符 连 接 起 来 的 字符 串 ， 例 
ii en-US, 

在 德国 ， 你 可 以 使 用 de-DE。 瑞 士 有 4 种 官方 语言 (德语 、 法 语 、 意 大 利 语 和 里 托 罗曼 
斯 语 )。 在 瑞士 讲 德 语 的 人 希望 使 用 的 locale 是 de-CH。 这 个 locale 会 使 用 德语 的 规则 ， 但 是 
货币 值 会 表示 成 珊 士 法 即 而 不 是 欧元 。 

如 果 只 指定 了 语言 ， 例 如 de， 和 那么 该 locale 就 不 能 用 于 与 国家 相关 的 场景 ， 例 如 货币 。 

我 们 可 以 像 下 面 这 样 用 标签 字符 串 来 构建 Locale 对 象 : 

Locale usEnglish = Locale. forLanguageTag("en-US") ; 

toLanguageTag 方法 可 以 生成 给 定 Locale 的 语言 标签 。 例 如 ，Loca1.US.toLanguageTag ( ) 
生成 的 字符 串 是 “en-US”。 

为 方便 起 见 ，Java SE 为 各 个 国家 预定 义 了 Locale 对 象 : 
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Locale. CANADA 
Locale. CANADA FRENCH 
Locale. CHINA 
Locale. FRANCE 
Locale. GERMANY 
Locale. ITALY 
Locale. JAPAN 
Locale.KOREA 
Locale. PRC 
Locale. TAIWAN 
Locale. UK 
Locale. US 


Java SE 还 预定 义 了 大 量 的 语言 Locale， 它 们 只 设 定 了 语言 而 没有 设 定 位 置 : 


Locale. CHINESE 

Locale. ENGLISH 

Locale. FRENCH 

Locale. GERMAN 

Locale. ITALIAN 

Locale. JAPANESE 

Locale. KOREAN 

Locale. SIMPLIFIED_CHINESE 
Locale. TRADITIONAL_CHINESE 


US, BRAM getAvailableLocale 77 }# 23 E H Java 虚拟 机 所 能 够 识别 的 所 有 
Locale 构成 的 数组 。 

除了 构建 一 个 Locale 或 使 用 预定 义 的 Locale 外， 还 可 以 有 两 种 方法 来 获得 一 个 
Locale 对 象 。 

Locale 类 的 静态 getdefault 方法 可 以 获得 作为 本 地 操作 系统 的 一 部 分 而 存放 的 默认 
Locale。 可 以 调用 setDefault 来 改变 默认 的 Java Locale ; 但 是 ， 这 种 改变 只 对 你 的 程序 
有 效 ， 不 会 对 操作 系统 产生 影响 。 

对 于 所 有 与 Locale 相关 的 工具 类 ， 可 以 返回 一 个 它们 所 支持 的 Locale 数组 。 比 如 ， 


Locale[] supportedLocales = NumberFormat.getAvailableLocales(); 
将 返回 所 有 DateFormat 类 所 能 够 处 理 的 Locale, 
GY 提示 : 为 了 测试 ， 你 也 许 希 望 改变 你 的 程序 的 默认 Locale， 可 以 在 启动 程序 时 提供 语 

言 和 地 域 特 性 。 比 如 ， 下 面 的 语句 将 默认 的 Locale 设 为 de-CH: 

java -Duser,1anguage=de -Duser.region=CH MyProgram 

一 旦 有 了 一 个 Locale， 你 能 用 它 做 什么 呢 ? 答案 是 它 所 能 做 的 事情 很 有 限 。Locale 类 
中 唯一 有 用 的 是 那些 识别 语言 和 国家 代码 的 方法 ， 其 中 最 重要 的 一 个 是 getdisplayName, 
它 返回 一 个 描述 Locale 的 字符 串 。 这 个 字符 串 并 不 包含 前 面 所 说 的 由 两 个 字母 组 成 的 代码 ， 
而 是 以 一 种 面向 用 户 的 形式 来 表现 ， 比 如 

German (Switzerland) 


事实 上 ， 这 里 有 一 个 问题 ， 显 示 的 名 字 是 以 默认 的 Locale 来 表示 的 ， 这 可 能 不 太 恰 当 。 
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如 果 你 的 用 户 已 经 选择 了 德语 作为 首选 的 语言 ， 那 么 你 可 能 希望 将 字符 串 显示 成 德语 。 通 过 
将 German Locale 作为 参数 传递 就 可 以 做 到 这 一 点 : 代码 


Locale loc = new Locale("de", "CH"); 
System.out.print]n(loc.getDisplayName(Locale.GERMAN)) ; 


将 打印 出 
Deutsch (Schweiz) 
这 个 例子 说 明了 为 什么 需要 Locale 对 象 。 你 把 它 传 给 Locale 感知 的 那些 方法 ， 这 些 
方法 将 根据 不 同 的 地 域 产生 不 同形 式 的 文本 。 在 下 一 节 中 你 可 以 见 到 大 量 的 例子 。 








e Locale(String language) 


e Locale(String language, String country) 

e Locale(String language, String country, String variant) 
用 给 定 的 语言 、 国 家 和 变量 创建 一 个 Locale。 在 新 代码 中 不 要 使 用 变 体 ， 应 该 使 用 
IETF BCP 47 语言 标签 。 

e static Locale forLanguageTag(String languageTag) 7 
构建 与 给 定 的 语言 标签 相对 应 的 Locale 对 象 。 

e static Locale getDefault() 


返回 默认 的 Locale。 


estatic void setDefault(Locale loc) 


设 定 默 认 的 Locale, 
e String getDisplayName() 


返回 一 个 在 当前 的 Locale 中 所 表示 的 用 来 描述 Locale 的 名 字 。 
e String getDisplayName(Locale loc) 


返回 一 个 在 给 定 的 Locale 中 所 表示 的 用 来 描述 Locale 的 名 字 。 
e String getLanguage( ) 

返回 语言 代码 ， 它 是 两 个 小 写字 母 组 成 的 ISO-639 代码 。 
e String getDisplayLanguage( ) 


返回 在 当前 Locale 中 所 表示 的 语言 名 称 。 

e String getDisplayLanguage(Locale loc) 
返回 在 给 定 Locale 中 所 表示 的 语言 名 称 。 

e String getCountry() 


返回 国家 代码 ， 它 是 由 两 个 大 写字 母 组 成 的 ISO-3166 代码 。 
e String getDisplayCountry() 


返回 在 当前 Locale 中 所 表示 的 国家 名 。 
e String getDisplayCountry(Locale loc) 
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返回 在 当前 Locale 中 所 表示 的 国家 名 。 
e String toLanguageTag() 7 
返回 该 Locale 对 象 的 语言 标签 ,例如 “de-CH”。 
e String toString() 
返回 Locale 的 描述 ， 包 括 语言 和 国家 ， 用 下 划 线 分 隅 (比如 ,“de_ CH”)。 应 该 只 在 
调试 时 使 用 该 方法 。 


7.2 ”数字 格式 


我 们 已 经 提 到 了 数字 和 货币 的 格式 是 高 度 依赖 于 locale 的 。Java 类 库 提 供 了 一 个 格式 器 
(formatter) 对 象 的 集合 ， 可 以 对 java.text 包 中 的 数字 值 进行 格式 化 和 解析 。 你 可 以 通过 
下 面 的 步骤 对 特定 Locale 的 数字 进行 格式 化 : 

1 ) 使 用 上 一 节 的 方法 ， 得 到 Locale 对 象 。 

2) 使 用 一 个 “工厂 方法 ”得 到 一 个 格式 郁 对 象 。 

3 ) 使 用 这 个 格式 器 对 象 来 完成 格式 化 和 解析 工作 。 

工厂 方法 是 NumberFormat 类 的 静态 方法 ， 它 们 接受 一 个 Locale 类 型 的 参数 。 总 共有 
3 个 工厂 方法 : getNumberInstance, getCurrencyInstance 和 getPercentInstance, 
这 些 方法 返回 的 对 象 可 以 分 别 对 数字 、 货 币 量 和 百分比 进行 格式 化 和 人 解析。 例如 ， 下 面 显示 
了 如 何 对 德语 中 的 货币 值 进行 格式 化 。 


Locale loc = Locale. GERMAN; 

NumberFormat currFmt = NumberFormat.getCurrencyInstance(loc) ; 
double amt = 123456.78; 

String result = currFmt. format (amt) ; 


结果 是 

123.456,78 € 

请 注意 ， 货 币 符号 是 E， 而 且 位 于 字符 串 的 最 后 。 同 时 还 要 注意 到 小 数 点 和 十 进 制 分 隅 
符 与 其 他 语言 中 的 情况 是 相反 的 。 

相反 地 ， 如 果 要 想 读 取 一 个 按照 某 个 Locale 的 惯用 法 而 输入 或 存储 的 数字 ， 那 么 就 需 
要 使 用 parse 方 法。 比如 ， 下 面 的 代码 解析 了 用 户 输 入 到 文本 框 中 的 值 。parse 方法 能 够 处 
理 小 数 点 和 分 隅 符 以 及 其 他 语言 中 的 数字 。 

TextField inputField; 

NunberFormat fmt = NumberFormat.getNumberInstance() ; 

// get the number formatter for default locale 


Number input = fmt.parse(inputField.getText().trim(); 
double x = input.doubleValue(); 


parse 的 返回 类 型 是 抽象 类 型 的 Number。 返 回 的 对 象 是 一 个 Double 或 Long 的 包装 
句 类 对 象 ， 这 取决 于 被 解析 的 数字 是 否 是 浮 点 数 。 如 果 不 关 心 两 者 的 差异 ， 可 以 直接 使 用 


r 
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Number 类 中 的 doubleValue 方法 来 读 取 被 包装 的 数字 。 


O SH: Number 类 型 的 对 象 并 不 能 自动 转换 成 相关 的 基本 类 型 ， 因 此 ， 不 能 直接 将 一 个 
Number 对 象 赋 给 一 个 基本 类 型 ， 而 应 该 使 用 doubleValue 或 intValue 方法 。 


如 果 数 字 文 本 的 格式 不 正确 ， 该 方法 会 抛 出 一 个 ParseException 异常 。 例 如 ， FR 

空白 字符 开头 是 不 允许 的 (可 以 调用 trim 方法 来 去 掉 它 )。 但 是 ， 任 何 跟 在 数字 之 后 的 字 
ww 所 以 这 些 跟 在 后 面 的 字符 是 不 会 引起 异常 的 。 

请 注意 ， 由 getXxxInstance 工 厂 方 法 返回 的 类 并 非 是 NumberFormat 类 型 的 。 
NumberFormat 类 型 是 一 个 抽象 类 ， 而 我 们 实际 上 得 到 的 格式 需 是 它 的 一 个 子 类 。 工 三 方法 
只 知道 如 何 定 位 属于 特定 locale 的 对 象 。 

可 以 用 静态 的 getAvailableLocales 方法 得 到 一 个 当前 所 支持 的 Locale 对 象 列表 。 
这 个 方法 返回 一 个 Locale 对 象 数组 ， 从 中 可 以 获得 针对 它们 的 数字 格式 需 对 象 。 

本 节 的 示例 程序 让 你 体会 到 了 数字 格式 需 的 用 法 
(参见 图 7-1 )。 图 上 方 的 组 合 框 包含 所 有 带 数 字 格式 器 [ohn 
的 Locale， 可 以 在 数字 、 货 币 和 百分率 格式 硕 之 间 进 
行 选择 。 每 次 你 改变 选择 ， 在 文本 框 中 的 数字 隋 会 被 CE SEE 
重新 格式 化 。 在 和 尝试 了 几 种 Locale 后 ， 你 就 会 对 有 图 7-1 NumberFormatTest 程序 
这 么 多 种 方式 来 格式 化 数字 和 贷 币值 而 感到 上 吃惊。 也 
可 以 输入 不 同 的 数字 并 点 击 Parse 按钮 来 调用 parse 方法 ， 这 个 方法 会 尝试 解析 你 输入 的 
内 容 。 如 果 解 析 成 功 ，format 方法 就 会 将 结果 显示 出 来 。 如 果 人 解析 失败 ， 文 本 框 中 会 显示 
“Parse error ”消息 。 

程序 清单 7-1 是 它 的 代码 ， 显 得 非常 直观 。 在 构造 器 中 ， 我 们 调用 NumberFromat. 
getAvailableLocales。 对 每 一 个 Locale， 我 们 调用 getDisplayName， 并 把 返回 的 结 
果 字 符 串 填 人 组 合 框 (字符 串 没 有 被 排序 ， 在 7.4 节 中 我 们 将 深入 研究 排序 问题 )。 一 旦 用 
户 选择 了 另 一 个 Locale 或 点 击 了 单 选 按钮 ， 我 们 就 创建 一 个 新 的 格式 器 对 象 并 更 新 文本 
框 。 当 用 户 点 击 Parse 按钮 后 ， 我 们 调用 Parse 方法 来 基于 选中 的 Locale 进行 实际 的 解 
析 操 作 。 


注意 : 你 可 以 使 用 Scanner 来 读 取 本 地 化 的 整数 和 浮 点 数 。 可 以 调用 useLocale 方法 
来 设置 locale。 








package numberFormat; 


import java.awt.*; 
import java.awt.event.*; 
import java.text.*; 
import java.util.*; 
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8 import javax.swing.*; 


10 /** 

11 * This program demonstrates formatting numbers under various locales. 
12 * Q@version 1.14 2016-05-06 

3 * @author Cay Horstmann 


4 */ 

15 public class NumberFormatTest 

1s { 

17 public static void main(String[] args) 

18 { 

19 EventQueue.invokeLater(() -> 

20 { 

21 JFrame frame = new NumberFormatFrame() ; 
22 frame.setTitle("NumberFormatTest’) ; 

23 frame. setDefaul tCloseOperation(JFrame.EXIT_ON_CLOSE) ; 
24 frame. setVisible(true) ; 

25 1 

26 } 

27} 

28 

29 /** 


30 * This frame contains radio buttons to select a number format, a combo box to pick a locale, a 
31 * text field to display a formatted number, and a button to parse the text field contents. 
32 */ 

3 Class NumberFormatFrame extends JFrame 

34 { 

35 private Locale[] locales; 

36 private double currentNumber; 

37 private JComboBox<String> localeCombo = new JComboBox<>() ; 

38 private JButton parseButton = new JButton("Parse’) ; 

39 private JTextField numberText = new JTextField(30) ; 

40 private JRadioButton numberRadioButton = new JRadioButton("Number”) ; 

41 private JRadioButton currencyRadioButton = new JRadioButton("Currency") ; 

42 private JRadioButton percentRadioButton = new JRadioButton("Percent') ; 

43 private ButtonGroup rbGroup = new ButtonGroup() ; 

44 private NumberFormat currentNumberFormat; 


46 public NumberFormatFrame() 


47 { 

48 SetLayout (new GridBagLayout()) ; 

49 

50 ActionListener listener = event -> updateDisplay(); 

51 

52 JPanel p = new JPanel (); 

53 addRadioButton(p, numberRadioButton, rbGroup, listener); 
54 addRadioButton(p, currencyRadioButton, rbGroup, listener); 
55 addRadioButton(p, percentRadioButton, rbGroup, listener) ; 
56 

57 add(new JLabel("Locale:"), new GBC(0, 0).setAnchor (GBC. EAST) ) ; 
58 add(p, new GBC(1, 1)); 

59 add(parseButton, new GBC(0, 2).setInsets(2)); 

60 add(localeCombo, new GBC(1, 0).setAnchor(GBC.WEST)) ; 


61 add(numberText, new GBC(1, 2).setFill (GBC.HORIZONTAL)) ; 
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locales = (Locale[]) NumberFormat.getAvailableLocales() .clone(); 

Arrays.sort(locales, Comparator. comparing(Locale: :getDisp]ayName)) ; 

for (Locale loc : locales) 
localeCombo.addItem(loc.getDisplayName()) ; 

localeCombo.setSelectedItem(Locale.getDefault() .getDisplayName()) ; 

currentNumber = 123456.78:; 

updateDisplay(); 


localeCombo.addActionListener(listener) ; 


parseButton.addActionListener(event -> 
{ 
String s = numberText.getText().trim() ; 
try 
{ 
Number n = currentNumberFormat.parse(s) ; 
if (n != null) 
{ 
currentNumber = n,doubleValue(); 
updateDisplayQ; 


else 


{ 


} 
} 
catch (ParseException e) 
{ 
numberText.setText("Parse error: " + s); 
} 
i 
pack() ; 


numberText.setText("Parse error: " + s); 


} 
[** 


* Adds a radio button to a container. 
* @param p the container into which to place the button 
* @param b the button 
* @param g the button group 
* @aram listener the button listener 
* 
/ 
public void addRadioButton(Container p, JRadioButton b, ButtonGroup g, ActionListener listener) 
{ 
b.setSelected(g.getButtonCount() == 0); 
b.addActionListener(listener) ; 
g.add(b) ; 
p.add(b) ; 
} 


/* 
* Updates the display and formats the number according to the user settings. 
*/ 

public void updateDi splay () 

{ 
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116 Locale currentLocale = locales{localeCombo.getSelectedIndex()] ; 

117 currentNumberFormat = null; 

118 if (numberRadioButton.isSelected()) 

119 currentNumberFormat = NumberFormat.getNumberInstance(currentLocale) ; 
120 else if (currencyRadioButton.isSelected()) 

121 currentNumberFormat = NumberFormat.getCurrencyInstance(currentLocale) ; 
122 else if (percentRadi oButton.isSelected()) 

123 currentNumberFormat = NumberFormat.getPercentInstance(currentLocale) ; 
124 String formatted = currentNumberFormat. format (currentNumber) ; 

125 numberText. setText (formatted) ; 





e static Locale[] getAvailableLocales() 
返回 一 个 Locale 对 象 的 数组 ， 其 成 员 包 含有 可 用 的 NumberFormat 格式 器 。 


e static NumberFormat getNumberInstance'( ) 


e static NumberFormat getNumberInstance(Locale 1) 

e static NumberFormat getCurrencyInstance( ) 

e static NumberFormat getCurrencyInstance(Locale 1) 

e static NumberFormat getPercentInstance() 

e static NumberFormat getPercentInstance(Locale 1) 
为 当前 的 或 给 定 的 locale FE HEA HAH. STN E ot LE AY AS ako 

e String format(double x) 

e String format(long x) 
对 给 定 的 浮 点 数 或 整数 进行 格式 化 并 以 字符 串 的 形式 返回 结 采 。 

e Number parse(String s) 
解析 给 定 的 字符 串 并 返回 数字 值 ， 如 果 输 入 字符 串 描 述 了 一 个 浮 点 数 ， 返 回 类 型 就 
Æ Double, 否则 返回 类 型 就 是 Long。 字 符 串 必须 以 一 个 数字 开头 ; 以 空 日 字符 开 
头 是 不 允许 的 。 数 字 之 后 可 以 跟随 其 他 字符 ， 但 它们 都 将 被 忽略 。 解 析 失 败 时 抛 出 
ParseException 异常 。 

e void setParseIntegerOnly(boolean b) 

e boolean isParseIntegerOnly( ) 
设置 或 获取 一 个 标志 ， 该 标志 指示 这 个 格式 器 是 否 应 该 只 解析 整数 值 。 

e void setGroupingUsed(boolean b) 

e boolean isGroupingUsed( ) 
设置 或 获取 一 个 标志 ， 该 标志 指示 这 个 格式 器 是 否 会 添加 和 识别 十 进 制 分 隅 符 〈 比 如 ， 
100 000 ) 。 

e void setMinimumIntegerDigits(int n) 


314 Java ZSRR A AAFF 


e int getMinimumIntegerDigits() 
e void setMaximumIntegerDigits(int n) 
e int getMaximumIntegerDigits() 
e void setMinimumFractionDigits(int n) 
e int getMinimumFractionDigits() 
èe void setMaximumFractionDigits(int n) 


e int getMaximumFractionDigits() 


设置 或 获取 整数 或 小 数 部 分 所 允许 的 最 大 或 最 小 位 数 。 


7.3 货币 


为 了 格式 化 货币 值 ， 可 以 使 用 NumberFormat .getCurrencyInstance 方 法 。 但 是 ， 
ee 它 返 回 的 是 一 个 只 针对 一 种 货币 的 格式 器 。 假 设 你 为 一 个 美国 客户 
准备 了 一 张 货物 单 ， 货 单 中 有 些 货物 的 金额 是 用 美元 表示 的 ， 有 些 是 用 欧元 表示 的 ， 此 时 ， 
你 不 naman, 


NumberFormat dollarFormatter = NumberFormat.getCurrencyInstance(Locale.US) ; 
NumberFormat euroFormatter = NumberFormat.getCurrencyInstance(Locale.GERMANY) ; 


因为 ， 这 样 一 来 ， 你 的 发 票 看 起 来 非常 奇怪 ， 有 些 金额 的 格式 像 $100 000， 另 一 些 则 像 
100.000 € (注意 ， 欧 元 值 使 用 小 数 点 而 不 是 逗号 作为 分 隔 符 )。 

处 理 这 样 的 情况 ， 应 该 使 用 Currency 类 来 控制 被 格式 器 所 处 理 的 货币 。 可 以 通过 将 一 
个 货币 标识 符 传 给 静态 的 Currency.getInstance 方法 来 得 到 一 个 Currency 对 象 ， 然 后 
对 每 一 个 格式 器 都 调用 setCurrency 方法 。 下 面 展示 如 何 为 你 的 美国 客户 设置 欧元 的 格式 : 


NumberFormat euroFormatter = NumberFormat.getCurrencyInstance(Locale.US); 
euroFormatter. setCurrency(Currency.getInstance("EUR")); 


货币 标识 符 由 ISO 4217 定 义 ， 可 参考 http://www.currency-iso.org/iso_index/iso_tables/ 
iso_tables_al.htm 中 的 列表 。 表 7-3 提供 了 其 中 的 一 部 分 。 


表 7-3 货币 标识 符 
货币 值 tr i 1 货币 值 标识 符 
U.S. Dollar USD Chinese Renminbi (Yuan) CNY 
Euro EUR Indian Rupee INR 
British Pound GBP Russian Ruble RUB 


Japanese Yen IPY 





e static Currency getInstance(String currencyCode) 


化 
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e static Currency getInstance(Locale locale) 
返回 与 给 定 的 ISO 4217 货币 代号 或 给 定 的 Locale 中 的 国家 相对 应 的 Curreny 对 象 。 
e String toString() 
e String getCurrencyCode( ) 
获取 该 货币 的 ISO 4217 代码 。 
e String getSymbol() 
e String getSymbol(Locale locale) 
根据 默认 或 给 定 的 Locale 得 到 该 货币 的 格式 化 符号 。 比 如 美元 的 格式 化 符号 可 能 是 
“$” 或 “US$”， 具体 是 哪 种 形式 取决 于 Locale。 
èe int getDefaultFractionDigits() 
获取 该 货币 小 数 点 后 的 默认 位 数 。 
estatic Set<Currency> getAvailableCurrencies() 7 


TRA A AT A Ge 


7.4 日 期 和 时 间 


当 格式 化 日 期 和 时 间 时 ， 需 要 考虑 4 个 与 Locale 相关 的 问题 : 

e 月 份 和 星期 应 该 用 本 地 语言 来 表示 。 

e 年 月 日 的 顺序 要 符合 本 地 习惯 。 

e 公历 可 能 不 是 本 地 首选 的 日 期 表示 方法 。 

e 必须 要 考虑 本 地 的 时 区 。 

java.time 包 中 的 DateTimeFormatter 类 可 以 处 理 这 些 问 题 。 首 先 挑选 表 7-4 中 所 示 
的 一 种 格式 风格 ， 然 后 获取 一 个 格式 带 : 


FormatStyle style=. . .; // One of FormatStyle.SHORT, FormatStyle.MEDIUM, .. . 

DateTimeFormatter dateFormatter = DateTimeFormatter.ofLocalizedDate(style) ; 

DateTimeFormatter timeFormatter = DateTimeFormatter.ofLocalizedTime(style) ; 

DateTimeFormatter dateTimeFormatter = DateTimeFormatter.ofLocalizedDateTime(style); 
// or DateTimeFormatter.ofLocalizedDateTime(stylel, style2) 


7-4 日 期 和 时 间 的 格式 化 风格 


SHORT 7/16/69 9:32 AM 
MEDIUM Jul 16, 1969 9:32:00 AM 


LONG July 16, 1969 9:32:00 AM EDT in en-US, 9:32:00 MSZ in de-DE 
( 只 用 于 ZonedDateTime) 


FULL Wednesday, July 16, 1969 9:32:00 AM EDT in en-US, 9:32 Uhr MSZ in de-DE 
( 只 用 于 ZonedDateTime) 


1 
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LORE TA ARSE AA ATAS Locale。 为 了 使 用 不 同 的 Locale， 需 要 使 用 withLocale 方法 ， 


DateTimeFormatter dateFormatter = 
DateTimeFormatter.ofLocalizedDate(style).withLocale(locale) ; 


现在 你 可 以 格式 化 LocalDate、LocalDateTime、LocalTime 和 ZonedDateTime 了 . 


ZonedDateTime appointment =.. .} 
String formatted = formatter. format (appointment) ; 


注意 : 这 里 我 们 使 用 的 是 java.time 包 中 的 DateTimeFormatter。 还 有 一 种 来 自 于 Java 
1.1 的 遗留 的 java.text.DateFormatter 类 ， 它 可 以 操作 Date 和 Calendar 对 象 ， 
可 以 使 用 LocalDate、LocalDateTime、LocalTime 和 ZonedDateTime 的 静态 的 parse 
方法 之 一 来 解析 字符 串 中 的 日 期 和 时 间 : 
LocalTime time = LocalTime.parse("9:32 AM", formatter); 
这 些 方法 不 适合 解析 人 类 的 输入 ， 至 少 是 不 适合 解析 未 做 预 处 理 的 人 类 输入 。 例 如 ， 用 
于 美国 的 短 时 间 格 式 需 可 以 解析 “9:32 AM”, 但 是 解析 不 了 “9:32AM” 和 “9:32 am”。 
O BS: 日 期 格式 器 可 以 解析 不 存在 的 日 期 ， 例 如 November 31， 它 会 将 这 种 日 期 调整 为 
给 定 月 份 的 最 后 一 天 。 
有 时 ， 你 需要 显示 星期 和 月 份 的 名 字 ， 例 如 在 日 历 应 用 中 。 此 时 可 以 调用 DayOfWeek 
和 Month 枚 举 的 getDisplayName F: 


for (Month m : Month.values()) 
System.out.printIn(m.getDisplayName(textStyle, locale) + " "); 





表 7-5 展 示 了 文本 风格 ， 其 中 表 7-5 java.time.format.TextStyle 枚 举 
STANDALONE 版 本 用 于 格式 化 日 期 之 外 风 格 x H 
的 显示 。 例 如 ， 在 分 兰 语 中 ， 一 月 在 日 FULL / FULL_STANDALONE January 
期 中 是 “tammikuuta”， 但 是 单独 显示 时 SHORT / SHORT_STANDALONE Jan 
是 “tammikuu”。 NARROW / NARROW_STANDALONE J 





注意 : 星期 的 第 一 天 可 以 是 星期 六 、 星 期 日 或 星期 一 ， 这 取决 于 Locale。 你 可 以 像 下 面 
这 样 获取 星期 的 第 一 天 : 


DayOfWeek first = WeekFields.of(locale), getFirstDayOfWeek(); 
程序 清单 7-2 展示 了 如 何在 实际 中 使 用 DateFormat 类 ， 用 户 可 以 选择 一 个 Locale 并 





package dateFormat; 


import java.awt.*; 
import java.awt.event.*; 
import java.time.*; 


vav hah Oe = 
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import java.time. format. *; 
import java.util.*; 


import javax.swing.*; 


/** 
* This program demonstrates formatting dates under various locales. 
* @version 1.00 2016-05-06 
* @author Cay Horstmann 


+ 
public class DateTimeFormatterTest 
{ 
public static void main(String[] args) 
{ 
EventQueue.invokeLater(() -> 
{ 
JFrame frame = new DateTimeFormatterFrame() ; 
frame, setTitle("DateFormatTest") ; 
frame. setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE) ; 
frame. setVisible(true) ; 
}); 
} 
} 
/** 


* This frame contains combo boxes to pick a locale, date and time formats, text fields to display 
* formatted date and time, buttons to parse the text field contents, and a "lenient" check box. 
* 
/ 
class DateTimeFormatterFrame extends JFrame 
{ 
private Locale[] locales; 
private LocalDate currentDate; 
private LocalTime currentTime; 
private ZonedDateTime currentDateTime; 
private DateTimeFormatter currentDateFormat; 
private DateTimeFormatter currentTimeFormat ; 
private DateTimeFormatter currentDateTimeFormat; 
private JComboBox<String> localeCombo = new JComboBox<>() ; 
private JButton dateParseButton = new JButton("Parse’) ; 
private JButton timeParseButton = new JButton("Parse’) ; 
private JButton dateTimeParseButton = new JButton("Parse’) ; 
private JTextField dateText = new JTextField(30); 
private JTextField timeText = new JTextField(30); 
private JTextField dateTimeText = new JTextField(30); 
private EnumCombo<FormatStyle> dateStyleCombo = new EnumCombo<>(FormatStyle.class, 
"Short", "Medium", "Long", "Full"); 
private EnumCombo<FormatStyle> timeStyleCombo = new EnumCombo<>(FormatStyle.class, 
"Short", "Medium") ; 
private EnumCombo<FormatStyle> dateTimeStyleCombo = new EnumCombo<>(FormatStyle.class, 
"Short", "Medium", "Long", "Full"); 


public DateTimeFormatterFrame() 


{ 
setLayout (new GridBagLayout()) ; 
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add(new JLabel ("Locale"), new GBC(0, 0).setAnchor(GBC.EAST)) ; 
add(localeCombo, new GBC(1, 0, 2, 1).setAnchor(GBC.WEST)) ; 


add(new JLabel("Date"), new GBC(0, 1).setAnchor(GBC. EAST)) ; 
add(dateStyleCombo, new GBC(1, 1).setAnchor(GBC.WEST)); 
add(dateText, new GBC(2, 1, 2, 1).setFil] (GBC.HORIZONTAL)) ; 
add(dateParseButton, new GBC(4, 1).setAnchor(GBC.WEST)) ; 


add(new JLabel ("Time"), new GBC(0, 2).setAnchor(GBC. EAST)) ; 
add(timeStyleCombo, new GBC(1, 2).setAnchor(GBC.WEST)) : 
add(timeText, new GBC(2, 2, 2, 1).setFill(GBC.HORIZONTAL)) ; 
add(timeParseButton, new GBC(4, 2).setAnchor(GBC.WEST)) ; 


add(new JLabel("Date and time"), new GBC(0, 3).setAnchor(GBC.EAST)); 
add(dateTimeStyleCombo, new GBC(1, 3).setAnchor(GBC.WEST)) ; 
add(dateTimeText, new GBC(2, 3, 2, 1).setFill (GBC.HORIZONTAL)); 
add(dateTimeParseButton, new GBC(4, 3).setAnchor(GBC.WEST)); 


locales = (Locale[]) Locale.getAvailableLocales().clone(); 

Arrays.sort(locales, Comparator. comparing(Locale: :getDisplayName)) ; 

for (Locale loc : locales) 
localeCombo.addItem(loc.getDisplayName()) ; 

localeCombo. setSelectedItem(Locale.getDefault() .getDisplayName()) ; 

currentDate = LocalDate.now(); 

currentTime = LocalTime.now(); 

currentDateTime = ZonedDateTime.now() ; 

updateDisplay(); 


ActionListener listener = event -> updateDisplay(); 


localeCombo.addActionListener(listener) ; 
dateStyleCombo.addActionListener(listener) ; 
timeSty]leCombo. addActionListener(listener) ; 
dateTimeSty]eCombo. addActionListener(listener) ; 


dateParseButton. addActionListener(event -> 


{ 
String d = dateText.getText().trimQ); 
try 
{ 


currentDate = LocalDate.parse(d, currentDateFormat) ; 
updateDisplay(); 


catch (Exception e) 
dateText.setText(e.getMessage()); 
}); 
timeParseButton.addActionListener(event -> 
String t = timeText.getText().trim(; 


try 
{ 
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114 currentTime = LocalTime.parse(t, currentTimeFormat) ; 
115 updateDisplay(); 

116 

117 catch (Exception e) 

118 

119 timeText, setText (e.getMessage()); 

120 } 

121 H; 

122 

123 dateTimeParseButton.addActionListener(event -> 

124 { 

125 String t = dateTimeText.getText().trim() ; 

126 try 

127 { 

128 currentDateTime = ZonedDateTime.parse(t, currentDateTimeFormat) ; 
129 updateDi splay(); 

130 } 

131 catch (Exception e) 

132 { 

133 dateTimeText. setText (e.getMessage()) ; 

134 } 

135 HD; 

136 

137 pack(); 

1338 } 

139 

140 /** 

141 * Updates the display and formats the date according to the user settings. 
142 a i 

13 public void updateDisplay() 

14  { 

145 Locale currentLocale = locales[localeCombo.getSelectedIndex()] ; 
146 FormatStyle dateStyle = dateSty]leCombo.getValue() ; 

147 currentDateFormat = DateTimeFormatter.ofLocalizedDate( 

148 dateStyle) .withLocale(currentLocale) ; 

149 dateText. setText (currentDateFormat. format (currentDate)) ; 

150 FormatStyle timeStyle = timeStyleCombo.getValue() ; 

151 currentTimeFormat = DateTimeFormatter.ofLocalizedTime( 

152 timeStyle) .withLocale(currentLocale) ; 

153 timeText. setText (currentTimeFormat. format (currentTime)) ; 

154 FormatStyle dateTimeStyle = dateTimeStyleCombo.getValue() ; 

155 currentDateTimeFormat = DateTimeFormatter.ofLocalizedDateTime( 
156 dateTimeStyle) .withLocale(currentLocale) ; 

157 dateTimeText. setText (currentDateTimeFormat. format (currentDateTime)) ; 
18S 

159 } 





图 7-2 显示 了 程序 (已 安装 中 文字 体 )。 就 像 你 看 到 的 那样 ， 输 出 能 够 正确 显示 。 

也 可 以 对 解析 进行 试验 。 输 入 一 个 日 期 或 时 间 ， 点 击 Parse lenient 复 选 框 (如 果 想 选 的 
话 )， 然 后 点 击 Parse date 或 Parse time 按钮 。 

我 们 使 用 辅助 类 EnumCombo 来 解决 一 个 技术 问题 (参见 程序 清单 7-3 )。 我 们 想 用 
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Short, Medium 和 Long 等 值 来 填充 一 个 组 合 框 (combo)， 然 后 自动 将 用 户 的 选择 转换 成 整 
数值 DateFormat .SHORT、DateFormat .MEDIUM 和 DateFormat .LONG。 我 们 并 没有 编写 


重复 的 代码 ， 而 是 使 用 了 反射 : 我 们 将 用 户 的 选择 转换 成 大 写字 母 ， 所 有 空格 都 用 下 划 线 替 
换 ， 然 后 找到 使 用 这 个 名 字 的 静态 域 的 值 。( 更 多 关于 反射 的 内 容 参 见 卷 1 第 5 章 。) 


ee 
图 7-2 DateFormatTest 程序 








1 package dateFormat; 

2 

3 Import java.util.*; 

4 import javax.swing.*; 

5 

6 /** 

7 * A combo box that lets users choose from among static field 
8 * values whose names are given in the constructor. 

9 * @version 1.15 2016-05-06 

10 * @author Cay Horstmann 

u */ 

12 public class EnumCombo<T> extends JComboBox<String> 

3 { 

14 private Map<String, T> table = new TreeMap<>(); 

15 

16 /** 

17 * Constructs an EnumCombo yielding values of type T. 

18 * @param cl a class 

19 * @param labels an array of strings describing static field names 
20 * of cl that have type T 

21 */ 

22 public EnumCombo(Class<?> cl, String... labels) 

23 { 

24 for (String label : labels) 

25 { 

26 String name = label.toUpperCase().replace(' ', '_'); 
27 try 

28 { 

29 java. lang.reflect.Field f = cl.getField(name) ; 

30 @SuppressWarnings ("unchecked") T value = (T) f.get(cl); 
31 table.put(label, value); 

32 

33 catch (Exception e) 

34 { 

35 label = "(" + label + ")"; 

36 table.put(label, null); 

37 } 
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38 addItem(label); 

39 } 

40 setSelectedItem(1abels[0]); 

41 } 

42 

43 /** 

44 * Returns the value of the field that the user selected. 
45 * @return the static field value 

46 */ 


47 public T getValue() 


49 return table.get(getSelectedItem()) ; 





e static DateTimeFormatter ofLocalizedDate(FormatStyle dateStyle) 
e static DateTimeFormatter ofLocalizedTime(FormatStyle dateStyle) 
e static DateTimeFormatter ofLocalizedDateTime(FormatStyle dateTimeStyle) 
estatic DateTimeFormatter ofLocalizedDate(FormatStyle dateStyle, 


FormatStyle timeStyle) 
返回 用 指定 的 风格 格式 化 日 期 、 时 间或 日 期 和 时 间 的 DateTimeF ormatter 实例 。 


e DateTimeFormatter withLocale(Locale locale) 


返回 当前 格式 器 的 具有 给 定 Locale 的 副本 。 


e String format(TemporalAccessor temporal ) 


返回 格式 化 给 定 日 期 /时间 所 产生 的 字符 串 。 





estatic Xxx parse(CharSequence text, DateTimeFormatter formatter ) 


解析 给 定 的 字符 串 并 返回 其 中 描述 的 LocalDate、LocalTime、LocalDateTime 或 
ZonedDateTime。 如 果 解 析 不 成 功 ， 则 抛 出 DateTimeParseException 异常 。 


7.5 “排序 和 范 化 


大 多 数 程序 员 都 知道 如 何 使 用 String 类 中 的 compareTo 方法 对 字符 串 进行 比较 。 但 
是 ， 当 与 人 类 用 户 交互 时 ， 这 个 方法 就 不 是 很 有 用 了 。compareTo 方法 使 用 的 是 字符 串 的 
UTF-16 编码 值 ， 这 会 导致 很 荒唐 的 结果 ， 即 使 在 英文 比较 中 也 是 如 此 。 比 如 ， 下 面 的 5 个 
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字符 串 进行 排序 的 结果 为 : 


America 
Zulu 
able 
zebra 
Angstrom 


按照 字典 中 的 顺序 ， 你 希望 将 大 写 和 小 写 看 作 是 等 价 的 。 对 于 一 个 说 英语 的 读者 来 说 ， 
期 望 的 排序 结果 应 该 是 : 


able 
America 
Angstrom 
zebra 
Zulu 


但 是 ， 这 种 顺序 对 于 瑞典 用 户 是 不 可 接受 的 。 在 瑞典 语 中 ， 字 母 A 和 字母 A 是 不 同 的 ， 
它 应 该 排 在 字母 Z 之 后 ! 就 是 说 ， 瑞 典 用 户 希 望 排序 的 结果 是 : 


able 
America 
zebra 
Zulu 
Angstrom 


为 了 获得 Locale 敏感 的 比较 符 ， 可 以 调用 静态 的 Collator.getInstance 方法 . 


Collator coll = Collator.getInstance(locale) ; 
words.sort(coll); // Collator implements Comparator<Object> 


因为 Collator 类 实现 了 Comparator 接口 ， 因 此 ， 可 以 传递 一 个 Co11ator 对 象 给 
list.sort(Comparator ) 方法 来 对 一 组 字符 串 进 行 排序 。 

排序 器 有 几 个 高 级 设置 项 。 你 可 以 设置 排序 器 的 强度 以 此 来 选择 不 同 的 排序 行为 。 字 符 
间 的 差别 可 以 被 分 为 首要 的 ( primary)、 其 次 的 ( secondary) 和 再 次 的 〈tertiary)。 比 如 ， 在 
喘 语 中 ,“ A” 和 “ZZ” 之 间 的 差别 被 归 为 首要 的 , 而 “A” 和 “A” 之 间 的 差别 是 其 次 的 ， 
“A” 和 “a” 之 间 是 再 次 的 。 

如 果 将 排序 器 的 强度 设置 成 Co11ator .PRIMARY， 那 么 排序 器 将 只 关注 primary 级 的 差 
别 。 如 有 果 设 置 成 Co11ator .SECONDARY， 排 序 器 将 把 secondary 级 的 差别 也 考虑 进去 。 就 是 
说 ， 两 个 字符 串 在 “secondary” 或 “tertiary” 强 度 下 更 容易 被 区 分 开 来 ， 如 表 7-4 所 示 。 

如 果 强 度 被 设置 为 Co11ator .IDENTICAL， 则 不 允许 有 任何 差异 。 这 种 设置 在 与 排序 器 
的 第 二 种 具有 相当 技术 性 的 设置 ， 即 分 解 模式 (decomposition mode)， 联 合 使 用 时 ， 就 会 显 
得 非常 有 用 。 我 们 接 下 来 将 讨论 分 解 模 式 。 

表 7-6 不 同 的 强度 下 的 排序 (英语 Locale) 


H 要 其 次 再 次 
Angstrom =Angstrém Angstrom # Ångström Angstrom # Ångström 
Able = able Able = able Able # able 
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偶尔 我 们 会 碰 到 一 个 字符 或 字符 序列 在 描述 成 Unicode 时 ， 可 以 有 多 种 方式 。 例 如 ， 
“ A” 可 以 是 Unicode 字符 U+00C5， et pt A (U+0065 ) 后 跟 ” (“上 方 组 
合 环 "，U+030A)。 也 许 会 让 你 更 吃惊 的 是 ， 字 母 序列 “ ffi” 可 以 用 代码 U+FB03 描述 成 单 
个 字符 “拉丁 小 连 字 ffi”。( 有 人 会 edie 不 应 该 因此 产生 不 同 的 Unicode 
字符 ， 但 我 们 不 会 作 这 样 的 规定 ) 

Unicode 标准 对 字符 串 定义 了 四 种 范 化 形式 (normalization form): D、KD、C 和 KC, 请 
查看 http://www.unicode.org/unicode/reports/tr15/tr15-23.html 以 了 解 详 细 信息 。 在 范 化 形式 C 
中 ,重音 符号 总 是 组 合 的 。 例 如 ，A 和 上 方 组 合 环 ”被 组 合成 了 单个 字符 A。 在 范 化 形式 D 
中 ， 重 音字 符 被 分 解 为 基 字 符 和 组 合 重音 符 。 例 如 ，A 就 被 转换 成 由 字母 A 和 上 方 组 合 环 ” 
构成 的 序列 。 范 化 形式 KC 和 KD 也 会 分 解 字符 ， 例 如 ffi 连 字 或 商标 符号 。 

我 们 可 以 选择 排序 器 所 使 用 的 范 化 程度 : Co11ator .NO_DECOMPOSITION 表示 不 对 字符 
串 做 任何 范 化 ， 这 个 选项 处 理 速度 较 快 ， 但 是 对 于 以 多 种 形式 表示 字符 的 文本 就 显得 不 适用 
J; 默认 值 Co11ator .CANONICAL_DECOMPOSITION 使 用 范 化 形式 D， 这 对 于 包含 重音 但 
不 包含 连 字 的 文本 是 非常 有 用 的 形式 ; 最 后 是 使 用 范 化 形式 KD 的 “完全 分 解 ”。 请 参见 表 7-7 
中 的 示例 : 

表 7-7 分 解 模式 之 间 的 差异 


不 分 解 规范 分 解 完全 分 解 
A # A° =A° A=A° 
™ 4 TM ™ «TM ™=TM 


让 排序 器 去 多 次 分 解 一 个 字符 串 是 很 浪费 的 。 如 果 一 个 字符 串 要 和 其 他 字符 串 进 行 
多 次 比较 ， 可 以 将 分 解 的 结果 保存 在 一 个 排序 键 对 象 中 。getCcol1ationKey 方法 返回 一 
个 CollationKey 对 象 ， 可 以 用 它 来 进行 更 进一步 的 、 更 快速 的 比较 操作 。 下 面 是 一 
例子 : 


String a = 
Col lationKey ioe coll .getCol lationKey (a) ; 
if(akey.compareTo(coll.getCollationKey(b)) == 0) // fast comparison 


最 后 ， 有 可 能 在 你 不 需要 进行 排序 时 ， 也 希望 将 字符 串 转换 成 它们 的 范 化 形式 。 例 如 ， 
在 将 字符 串 存储 到 数据 库 中 ,或 与 其 他 程序 进行 通信 时 。java.text.Normalizer 类 实现 
了 对 范 化 的 处 理 。 例 如 : 


String name = "Angstrom": 
String normalized = Normalizer.normalize(name, Normalizer.Form.NFD); // uses normalization form D 


Lm Reta ae 10 AFA, HP “A” M “6” HRT “AS” Aon” 
序列 。 

但 是 ， 这 通常 并 非 用 于 存储 或 传输 的 最 佳 形式 。 范 化 形式 C 首先 进行 分 解 ， 然 后 将 重音 
按照 标准 化 的 顺序 组 合 在 后 面 。 根 据 W3C 的 标准 ， 这 是 用 于 在 因特网 上 进行 数据 传输 的 推 


ë 
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a 
序 清单 7-4 中 的 程序 让 你 体验 了 一 下 比较 排序 。 向 文生 
eg Add 按钮 把 它 添加 到 一 个 单词 列 | senso 
表 中 。 每 当 添 加 一 个 单词 ， 或 选择 locale 、 强 度 或 分 解 模 式 ， 
列表 中 的 单词 就 会 被 重新 排列 。= 号 表示 这 两 个 词 被 认为 是 
等 同 的 (参见 图 7-3 )。 
在 组 合 框 中 的 locale 名 的 显示 顺序 ， 是 用 默认 locale 的 
HEFE RRES 了 排序 而 产生 的 顺序 。 如 果 用 美国 英语 locale iz 
行 这 个 程序 ， 即 使 逗号 的 Unicode 值 比 右 括号 的 Unicode 值 
rig ‘Norwegian (Norway,Nynorsk)” 也 会 显示 在 “Norwegian 
(Norway)” 的 前 面 。 





图 7-3 CollationTest 程序 





package collation; 


import java.awt.*; 
import java.awt.event.*; 
import java. text.*; 
import java.util.*; 
import java.util.List; 


O oO N cn a A ù N 


import javax.swing.*; 


pen 
o 


/** 
* This program demonstrates collating strings under various locales. 
* @version 1.15 2016-05-06 
* @author Cay Horstmann 


Fe Fe h ë ea 
P uù N ee 


15 */ 

16 public class CollationTest 

17 { 

18 public static void main(String[] args) 

19 { 

20 EventQueue.invokeLater(() -> 

21 

22 JFrame frame = new CollationFrame(); 
23 frame.setTitle("CollationTest"); 

24 frame. setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE) ; 
25 frame, setVisible(true) ; 

26 外 

27 } 

28 } 

29 

30 /** 


31 * This frame contains combo boxes to pick a locale, collation strength and decomposition rules, 
32, * a text field and button to add new strings, and a text area to list the collated strings. 

3 */ 

34 Class CollationFrame extends JFrame 


35 { 
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private Collator collator = Collator.getInstance(Locale.getDefault()) ; 

private List<String> strings = new ArrayList<>(); 

private Collator currentCol lator; 

private Locale[] locales; 

private JComboBox<String> localeCombo = new JComboBox<>() ; 

private JTextField newWord = new JTextField(20); 

private JTextArea sortedWords = new JTextArea(20, 20); 

private JButton addButton = new JButton("Add") ; 

private EnumCombo<Integer> strengthCombo = new EnumCombo<>(Collator.class, "Primary", 
"Secondary", "Tertiary", "Identical"); 

private EnumCombo<Integer> decompositionCombo = new EnumCombo<>(Collator.class, 
"Canonical Decomposition”, "Full Decomposition", "No Decomposition"); 


public CollationFrame() 

{ 
setLayout (new GridBagLayout()); 
add(new JLabel ("Locale"), new GBC(0, 0).setAnchor (GBC. EAST)) ; 
add(new JLabel ("Strength"), new GBC(0, 1).setAnchor(GBC.EAST)) ; 
add(new JLabel ("Decomposition"), new GBC(0, 2).setAnchor(GBC.EAST)) ; 
add(addButton, new GBC(0, 3).setAnchor (GBC. EAST)) ; 
add(localeCombo, new GBC(1, 0).setAnchor(GBC.WEST)); 
add(strengthCombo, new GBC(1, 1).setAnchor(GBC.WEST)) ; 
add(decompositionCombo, new GBC(1, 2).setAnchor(GBC.WEST)) ; 
add(newWord, new GBC(1, 3).setFil] (GBC.HORIZONTAL)) ; 
add(new JScrol|]Pane(sortedWords), new GBC(O, 4, 2, 1).setFill (GBC.BOTH)); 


locales = (Locale[]) Collator.getAvailableLocales().clone(); 
Arrays. sort( 
locales, (11, 12) -> collator.compare(11.getDisplayName(), 12.getDisplayName())); 
for (Locale loc : locales) 
localeCombo.addItem(loc.getDisplayName()) ; 
localeCombo. setSelectedItem(Locale.getDefault() .getDisplayName()) ; 


strings.add ("America") ; 
strings.add("able") ; 
strings.add("Zulu") ; 
Strings.add("zebra") ; 
strings.add("\u00CSngstr\u00F6m") ; 
strings.add("A\u030angstro\u0308m") ; 
Strings.add("Angstrom’) ; 
strings.add("Able") ; 
strings.add("office") ; 

strings. add("o\uFB03ce") ; 
Strings.add("Java\u2122"); 
Strings.add("JavaTM") ; 
updateDisplay(); 


addButton.addActionListener(event -> 


{ 
strings.add(newWord.getText()); 
updateDisplay(Q); 

D; 


ActionListener listener = event -> updateDisplay(); 


i 
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91 local eCombo. addActionListener(listener) ; 

92 StrengthCombo. addActionListener(listener) ; 

93 decomposi tionCombo. addActionListener(listener); 

94 pack(); 

95 } 

96 

97 /** 

98 * Updates the display and collates the strings according to the user settings. 
99 */ 

100 public void updateDisplay() 

101 è { 

102 Locale currentLocale = locales[localeCombo.getSelectedIndex()]; 
103 local eCombo. setLocale(currentLocale) ; 

104 

105 currentCollator = Collator.getInstance(currentLocale) ; 

106 currentCollator.setStrength(strengthCombo.getValue()); 

107 currentCol lator. setDecomposi tion (decomposi ti onCombo.getValue()) ; 
108 

109 Collections.sort(strings, currentCollator); 

110 

111 sortedWords.setText(""); 

112 for (int i = 0; i < strings.size(); i++) 

113 { 

114 String s = strings.get(i); 

115 if (i > 0 && currentCollator.compare(s, strings.get(i - 1)) == 0) 
116 sortedWords.append("= "); 

117 sortedWords.append(s + "\n"); 

118 

119 pack(); 





e static Locale[] getAvailableLocales() 


返回 Locale 对 象 的 一 个 数组 ， 该 Collator 对 象 可 用 于 这 些 对 象 。 


e static Collator getInstance( ) 


e static Collator getInstance(Locale 1) 


为 默认 或 给 定 的 locale 返回 一 个 排序 器 。 
eint compare(String a, String b) 
WR a 在 b 之 前 ， 则 返回 负 值 ; 如 果 它 们 等 价 ， 则 返回 0， 否则 返回 正 值 。 
ə boolean equals(String a, String b) 
如 有 果 它 们 等 价 ， 则 返回 true, FURE false, 
evoid setStrength(int strength) 
e int getStrength() 
TC A BM OR HE AF ae A RE. EaR ER AF A KA Se), RE AY ET A E 


化 音 IT 
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Collator.PRIMARY, Collator. SECONDARY fil Collator. TERTIARY, 

e void setDecomposition(int decomp) 

e int getDecompositon( ) 
设置 或 获取 排序 器 的 分 解 模 式 。 分 解 越 细 ， 判 断 两 个 字符 串 是 否 相 等 时 就 越 严 格 。 分 
解 的 等 级 值 可 以 是 Co11ator .NO_DECOMPOSITION、Collator . 
CANONICAL_DECOMPOSITION 和 Collator.FULL_DECOMPOSITION。 

e CollationKey getCollationKey(String a) 
返回 一 个 排序 器 键 ， 这 个 键 包含 一 个 对 一 组 字符 按 特定 格式 分 解 的 结果 ， 可 以 快速 地 
和 其 他 排序 器 键 进 行 比较 。 


ee PLC 





e int compareTo(CollationKkey b) 


如 果 这 个 键 在 b 之 前 ， 则 返回 一 个 负 值 ;如 采 两 者 


e static String normalize(CharSequence str, Normalizer.Form form) 


返回 str 的 范 化 形式 ，form 的 值 是 ND、NKD、NC 或 NKC 之 一 。 


价 ， 则 返回 0， 否则 返回 正 值 。 


Me Re EM 
(ae Cs 






7.6 ”消息 格式 化 


Java 类 库 中 有 一 个 MessageFormat 类 ， 它 与 用 printf 方法 进行 格式 化 很 类 似 , 但 是 
它 支持 Locale， 并 且 会 对 数字 和 日 期 进行 格式 化 。 我 们 将 在 以 下 各 节 中 审视 这 种 机 制 。 


7.6.1 格式 化 数字 和 日 期 


下 面 是 一 个 典型 的 消息 格式 化 字符 串 : 

"On {2}, a {0} destroyed {1} houses and caused {3} of damage." 

括号 中 的 数字 是 占 位 符 ， 可 以 用 实际 的 名 字 和 值 来 替换 它们 。 使 用 静态 方法 
MessageFormat .format 可 以 用 实际 的 值 来 替换 这 些 占 位 符 。 它 是 一 个 “varargs ”方法 ， 
所 以 你 可 以 通过 下 面 的 方法 提供 参数 : 


String msg = MessageFormat.format("On {2}, a {0} destroyed {1} houses and caused {3} of damage.", 
"hurricane", 99, new GregorianCalendar(1999, 0, 1).getTime(), 10.068); 


在 这 个 例子 中 ， 占 位 符 {0} BE “hurricane” FR, {1} 被 99 替换， 等 等 。 

上 述 例子 的 结果 是 下 面 的 字符 串 : 

On 1/1/99 12:00 AM, a hurricane destroyed 99 houses and caused 100,000,000 of damage, 

这 只 是 开始 ， 离 完美 还 有 距离 。 我 们 不 想 将 时 间 显 示 为 “12:00 AM”, MERTEKE 
成 的 损失 量 打 印 成 货币 值 。 通 过 为 占 位 符 提供 可 选 的 格式 ， 就 可 以 做 到 这 一 反 : 
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"On {2,date,long}, a {0} destroyed {1} houses and caused {3, number, currency} of damage." 
这 段 示例 代码 将 打印 出 : 
On January 1, 1999, a hurricane destroyed 99 houses and caused $100,000,000 of damage. 


一 般 来 说 ， 占 位 符 索 引 后 面 可 以 跟 一 个 类 型 (type) 和 一 个 风格 (style)， 它 们 之 间 用 到 
写 隅 开 。 类 型 可 以 是 : 


number 
time 
date 
choice 


如 果 类 型 是 number， 那 么 风格 可 以 是 


integer 
currency 
percent 


或 者 可 以 是 数字 格式 模式 ， 就 像 $,##0。( 关 于 格式 的 更 多 人 信息， 参见 DecimalFormat 类 的 
文档 。) 
如 果 类 型 是 time 或 date， 那 么 风格 可 以 是 


short 
medium 
long 
full 


或 者 是 一 个 日 期 格式 模式 ， 就 像 yyyy-MM-dd。( 关 于 格式 的 更 多 信息 ， 参 见 SimpleDateFormat 

类 的 文档 。) 

Q 警告 : 静态 的 MessageFormat .format 方法 使 用 当前 的 locale 对 值 进行 格式 化 。 要 想 
用 任意 的 locale 进行 格式 化 ， 还 有 一 些 工 作 要 做 ， 因 为 这 个 类 还 没有 提供 任何 可 以 使 用 
的 “varargs” 方 法 。 你 需要 把 将 要 格式 化 的 值 置 于 Object[] 数组 中 ， 就 像 下 面 这 样 : 


MessageFormat mf = new MessageFormat(pattern, loc); 
String msg = mf.format(new Object[] { values }); 





e MessageFormat(String pattern) 


e MessageFormat(String pattern, Locale loc) 
用 给 定 的 模式 和 locale 构建 一 个 消息 格式 对 象 。 
e void applyPattern(String pattern) 
给 消息 格式 对 象 设置 特定 的 模式 。 
evoid setLocale(Locale loc) 
e Locale getLocale() 
设置 或 获取 消息 中 占 位 符 所 使 用 的 locale。 这 个 locale 仅仅 被 通过 调用 applyPattern 
方法 所 设置 的 后 续 模 式 所 使 用 。 
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e static String format(String pattern, Object... args) 
通过 使 用 args[i] 作为 占 位 符 {i} 的 输入 来 格式 化 pattern 字符 串 。 
e StringBuffer format(Object args, StringBuffer result, FieldPosition pos) 
格式 化 MessageFormat 的 模式 。args 参数 必须 是 一 个 对 象 数组 。 被 格式 化 的 字符 
串 会 被 附加 到 result 未 尾 ， 并 返回 result。 如 果 pos 等 于 new FieldPosition 
(MessageFormat .Field.ARGUMENT), 就 用 它 的 beginIndex 和 endIndex 属性 值 来 
设置 替换 占 位 符 {1} 的 文本 位 置 。 如 果 不 关心 位 置信 息 ， 可 以 将 它 设 为 nu11。 





e String See: obj) 
按照 格式 器 的 规则 格式 化 给 定 的 对 象 ， 这 个 方法 将 调用 format(obj,new 
StringBuffer(), new FieldPosition(1)).toString(), 


7.6.2 选择 格式 


让 我 们 仔细 地 看 看 前 面 一 节 所 提 到 的 模式 : 

"On {2}, a {0} destroyed {1} houses and caused {3} of damage." 

如 果 我 们 用 “ earthquake ”来 替换 代表 灾难 的 占 位 符 {0}， 那 么 ， 在 英语 中 ， 这 人 句 话 的 二 
法 就 不 正确 了。 

On January 1, 1999, a earthquake destroyed... . 

这 说 明 ， 我 们 真正 希望 的 是 将 冠 词 “a” 集 成 到 占 位 符 中 去 : 

"On {2}, {0} destroyed {1} houses and caused {3} of damage." 

这 样 我 们 就 应 该 用 “a hurricane” 3 “an earthquake” KEH {0}. 当 消 息 需 要 
被 翻译 成 某 种 语言 ， 而 该 语言 中 的 词 会 随 词性 的 变化 而 变化 时 ， 这 种 替换 方式 就 特别 运用 。 
比如 ， 在 德语 中 , Ca 

"{0} zerstörte am {2} {1} Hauser und richtete einen Schaden von {3} an." 


这 样 ， 占 位 符 将 被 正确 地 替换 成 冠 词 和 名 词 的 组 合 ， 比 如 “Ein Wirbelsturm” 


“Eine Naturkatastrophe”, 
让 我 们 来 看 看 参数 {1}。 如 果 灾 难 的 后 果 不 严 重 ，{1} 的 替换 值 可 能 是 数字 1， 消 息 就 变 成 : 


On January 1, 1999, a mudslide destroyed 1 houses and ，，， 


我 们 当然 希望 消息 能 够 随 占 位 符 的 值 而 变化 ， 这 样 就 能 根据 具体 的 值 形成 


no houses 
one house 
2 houses 


choice 格式 化 选项 就 是 为 了 这 个 目的 而 设计 的 。 
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一 个 选择 格式 是 由 一 个 序列 对 构成 的 ， 每 一 个 对 包括 

e 一 个 下 限 (lower limit) 

o 一 个 格式 字符 串 〈 format string) 

下 限 和 格式 字符 串 由 一 个 # 符号 分 隔 ， 对 与 对 之 间 由 符号 | 分 隔 。 
例如 ， 


{1,choice,0#no houses|l#one house|2#{1} houses} 
K 7-8 显示 了 格式 字符 串 对 {1} 的 不 同 值 产生 的 作用 。 
表 7-8 由 选择 格式 进行 格式 化 的 字符 串 


{1} 结 R {1} 结 R 
0 "no houses" 3 "3 houses" 
1 "one house" 一 1 "no houses" 


为 什么 在 格式 化 字符 串 中 两 次 用 到 了 {1} ? 当 消 息 格式 将 选择 的 格式 应 用 于 占 位 符 {1} 
而 且 替 换 值 是 2 时， 那么 选择 格式 会 返回 “ {1} houses”。 这 个 字符 串 由 消息 格式 再 次 格式 
化 ， 并 将 这 次 的 结果 和 上 一 次 的 赦 加 。 


注意 : 这 个 例子 说 明 选 择 格式 的 设计 者 有 些 糊 涂 了 。 如 果 你 有 3 个 格式 字符 串 ， 你 就 需 
要 两 个 下 限 来 分 隔 它们 。 一 般 来 说 ， 你 需要 的 下 限 数目 比 格式 字符 串 数 目 少 1。 就 像 你 
在 表 7-8 中 见 到 的 ，MessageFormat 类 将 忽略 第 一 个 下 限 。 

如 果 这 个 类 的 设计 者 意识 到 下 限 只 在 两 个 选择 之 间 出 现 ， 那 么 语法 就 要 清楚 得 多 ， 比 如 ， 
no houses|1jone house|2|{1} houses // not the actual format 

可 以 使 用 < 符号 来 表示 如 果 替 换 值 严 格 小 于 下 限 ， 则 选中 这 个 选择 项 。 

也 可 以 使 用 < (unicode 中 的 代码 是 \u2264) 来 实现 和 # 相同 的 效果 。 如 果 愿 意 的话 ， 甚 

至 可 以 将 第 一 个 下 限 的 值 定 义 为 -~ % (unicode 代码 是 -\u221E), 
例如 ， 


-co<no houses|0<one house|2<{1} houses 
或 者 使 用 Unicode 转 义 字符 ， 

-\u221E<no houses|Q<one house|2\u2264{1} houses 

让 我 们 来 结束 自然 灾害 的 场景 。 如 果 我 们 将 选择 字符 串 放 到 原始 消息 字符 串 中 ， 那 么 我 
们 得 到 下 面 的 格式 化 指令 : 


String pattern = "On {2,date,long}, {0} destroyed {1,choice,0#no houses|1#one house|2#{1} 
houses}" + "and caused {3,number,currency} of damage. "; 


在 德语 中 ， 即 


String pattern = "{0} zerstörte am {2,date,long} {1,choice,O#kein Haus|1#ein Haus|2#{1} Hauser}" 
+ "und richtete einen Schaden von {3,number, currency} an.": 


请 注意 ， 在 德语 中 词 的 顺序 和 英语 中 是 不 同 的 ， 但 是 你 传 给 format 方法 的 对 象 数组 是 相 


华 
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同 的 。 可 以 用 格式 字符 串 中 占 位 符 的 顺序 来 处 理 单词 顺序 的 改变 。 


7.7 文本 文件 和 字符 集 


众所周知 ，Java 编程 语言 自身 是 完全 基于 Unicode 的 。 但 是 ，Windows 和 Mac OS X 仍 
旧 支 持 遗 留 的 字符 编码 机 制 ， 例 如 西欧 国家 的 Windows-1252 和 Mac Roman, 以 及 中 国 台 湾 
的 Big5。 因 此 ， 与 用 户 通 过 文本 沟通 并 非 看 上 去 那么 简单 。 下 面 各 节 将 讨论 你 可 能 会 碰 到 的 
各 种 复杂 情况 。 
7.7.1 文本 文件 

当今 ， 最 好 是 使 用 UTF-8 来 存储 和 加 载 文本 文件 ， 但 是 你 需要 操作 遗留 文件 。 如 末 你 知 
道 遗留 文件 所 希望 使 用 的 字符 编码 机 制 ， 那 么 可 以 在 读 写 文本 文件 时 指定 它 : 

PrintWriter out = new PrintWriter(filename, "Windows-1252"); 

如 果 想 要 获得 最 佳 的 编码 机 制 ， 可 以 通过 下 面 的 调用 来 获得 “平台 的 编码 机 制 ”: 


Charset platformEncoding = Charset.defaultCharset() ; 
7.7.2 ITARA 


这 不 是 Locale 的 问题 ， 而 是 平台 的 问题 。 在 Windows 中 ， 文 本 文件 希望 在 每 行 末 尾 使 
用 N\rN\n， 而 基于 UNIX 的 系统 只 需要 一 个 \n 字符 。 当 今 ， 大 多 数 Windows 程序 都 可 以 处 
理 只 有 一 个 \n 的 情况 ， 一 个 重要 的 例外 是 记事 本 。 如 果 “ 用 户 可 以 在 你 的 应 用 所 产生 的 文 
本 文件 上 双击 并 在 记事 本 中 浏览 它 ” 对 你 来 说 非常 重要 ， 那 么 你 就 要 确保 该 文本 文件 使 用 了 
正确 的 行 结束 符 。 

任何 用 printin 方法 写 入 的 行 都 会 是 被 正确 终止 的 。 唯 一 的 问题 是 你 是 否 打印 了 包含 
\n 字符 的 行 。 它 们 不 会 被 自动 修改 为 平台 的 行 结束 符 。 

与 在 字符 串 中 使 用 \n 不 同 ， 可 以 使 用 printf 和 %n 格式 说 明 符 来 产生 平台 相关 的 行 第 
束 符 。 例 如 ， 

out.printf("Hello%nWorld%n") ; 
会 在 Windows 上 产生 

Hello\r\nWorld\r\n 
而 在 其 他 所 有 平台 上 产生 

Hello\nWorld\n 


7.7.3 控制 台 


如 果 你 编写 的 程序 是 通过 System. in/System. out 或 System.console'( ) 与 用 户 交 互 
的 ， 那 么 就 不 得 不 面 对 控制 台 使 用 的 字符 编码 机 制 与 CharSet.defaultCharset() 报告 的 
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平台 编码 机 制 有 所 差异 的 可 能 性 。 当 使 用 Windows 上 的 cmd 工具 时 ， 这 个 问题 尤其 需要 注 
意 。 在 美国 版 本 中 ， 命 令 行 Shell 使 用 的 是 陈旧 的 IBM437 编码 机 制 ， 它 源 自 于 1982 年 IBM 
的 个 人 计算 机 。 没 有 任何 官方 的 API 可 以 揭示 该 信息 。Charset.defaultCharset() 方法 
将 返回 Windows-1252 字符 集 ， 它 与 IBM437 完全 不 同 。 例 如 ， 在 Windows-1252 中 有 欧元 
RSE, {ALTE IBM437 中 没有 。 如 果 调 用 

System.out.print]n("100 €"); 

控制 台 会 显示 

100 ? 

你 可 以 建议 用 户 切换 控制 台 的 字符 编码 机 制 。 在 Windows 中 ， 这 可 以 通过 chcp 命令 实 
现 。 例 如 : 

chcp 1252 
会 将 控制 台 变换 为 Windows-1252 编码 页 。 

当然 ， 理 想 情况 下 你 的 用 户 应 该 将 控制 台 切 换 到 UTF-8。 在 Windows 中 ， 该 命令 为 : 

Chcp 65001 

遗憾 的 是 ， 这 种 命令 还 不 足以 让 Java 在 控制 台中 使 用 UTF-8， 我 们 还 必须 使 用 非 官方 的 
file.encoding 系统 属性 来 设置 平台 的 编码 机 制 : 


java -Dfile.encoding=UTF-8 MyProg 


7.74 .日志 文件 


“RA java.util.logging 库 的 日 志 消 息 被 发 送 到 控制 台 时 ， 它 们 会 用 控制 台 的 
编码 机 制 来 书写 。 在 上 一 节 中 你 看 到 了 如 何 进行 控制 。 但 是 ,文件 中 的 日 志 消 息 会 使 用 
FileHandler 来 处 理 ， 它 在 默认 情况 下 会 使 用 平台 的 编码 机 制 。 

要 想 将 编码 机 制 修改 为 UTF-8， 需 要 修改 日 志 管 理 器 的 设置 。 具 体 做 法 是 在 日 志 配 置 文 
件 中 做 如 下 设置 .: 


java.util.logging.FileHandler.encoding=UTF-8 


7.7.5 UTF-8 字 节 顺序 标志 


正如 我 们 已 经 提 到 的 ， 尽 可 能 地 让 文本 文件 使 用 UTF-8 是 一 个 好 的 做 法 。 如 果 你 的 应 
用 必须 读 取 其 他 程序 创建 的 UTF-8 文本 文件 ， 那 么 你 可 能 会 碰 到 另 一 个 问题 。 在 文件 中 添 
加 一 个 “ 字 节 顺序 标志 ”字符 U+FEFF 作为 文件 的 第 一 个 字符 ， 是 一 种 完全 合法 的 做 法 。 在 
UTF-16 编码 机 制 中 ， 每 个 码 元 都 是 一 个 两 字 节 的 数字 ， 字 节 顺 序 标志 可 以 告诉 读 人 器 该 文 
件 使 用 的 是 “高 字 节 在 前 ”还 是 “ 低 字 节 在 前 ”的 字 节 顺序 。UTF-8 是 一 种 单字 节 编 码 机 制 ， 
因此 不 需要 指定 字 节 的 顺序 。 但 是 如 果 一 个 文件 以 字 节 0xEF 0xBB OxBF(U+FEFF 的 UTF-8 
编码 ) 开头 ， 那 么 这 就 是 一 个 强烈 暗示 ， 表 示 该 文件 使 用 了 UTF-8。 正 是 因为 这 个 原因 ， 
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Unicode 标准 鼓励 这 种 实践 方式 。 任 何 读 和 人 喜 都 被 认为 会 丢弃 最 前 面 的 字 节 顺序 标志 。 

还 有 一 个 美中不足 的 瑕 竟 。Oracle 的 Java 实现 很 固执 地 因 湾 在 的 兼容 性 问题 而 拒绝 还 循 
Unicode 标准 。 作 为 程序 员 ， 这 对 你 而 言 意味 着 必须 去 执行 平台 并 不 会 执行 的 操作 。 在 读 和 人 
文本 文件 时 ， 如 果 开 头 碰 到 了 U+FEFF ， 那 么 就 忽略 它 。 

O FE AROZ, JDK 的 实现 没有 遵循 这 项 建议 。 在 向 javac 编译 器 传递 有 效 的 以 字 节 顺 

序 标 志 开 头 的 UTF-8 源 文 件 时 ， 编 译 会 以 产生 错误 消息 “illegal character: \65279” 而 失败 。 


7.7.6 ” 源 文件 的 字符 编码 


作为 程序 员 ， 要 牢记 你 需要 与 Java 编译 器 交互 ， 这 种 交互 需要 通过 本 地 系统 的 工具 来 完成 。 
例如 ， 可 以 使 用 中 文 版 的 记事 本 来 写 你 的 Java 源 代 码 文件 。 但 这 样 写 出 来 的 源码 不 是 随处 可 用 
的 ， 因 为 它们 使 用 的 是 本 地 的 字符 编码 (GB 或 Big5， 这 取决 于 你 使 用 的 是 哪 种 中 文 操 作 系 统 )。 
只 有 编译 后 的 class 文件 才能 随处 使 用 ， 因 为 它们 会 自动 地 使 用 “ modified UTF-8” 编 码 来 处 理 标 
识 符 和 字符 串 。 这 意味 着 即使 在 程序 编译 和 运行 时 ， 依 然 有 3 种 字符 编码 参与 其 中 : 

o 类 文件 : modified UTF-8 

e 虚拟 机 : UTF-16 

关于 modified UTF-8 和 UTF-16 格式 的 定义 ， 参 见 第 2 章 。 
& 提示 : 你 可 以 用 -encoding 标记 来 设 定 你 的 源 文件 的 字符 编码 ， 例 如 

javac -encoding UTF-8 Myfile. java 

为 了 使 你 的 源 文件 能 够 到 处 使 用 ， 必 须 使 用 普通 的 ASCII 编码 。 就 是 说 ， 你 需要 将 所 
有 非 ASCII 字符 转换 成 等 价 的 Unicode 编码 。 比 如 ， 不 要 使 用 字符 串 “ Hiuser”， 应 该 使 用 
“H\u0084user”。JDK 包含 一 个 工具 一 一 native2ascii， 可 以 用 它 来 将 本 地 字符 编码 转换 
成 普通 的 ASCII。 这 个 工具 直接 将 输入 中 的 每 一 个 非 ASCII 字符 和 蔡 换 为 一 个 \u 加 四 位 十 六 
进 制 数字 的 Unicode 值 。 使 用 native2ascii 时 ， 需 要 提供 输入 和 输出 文件 的 名 字 : 


native2ascii Myfile.java Myfile.temp 
可 以 用 -reverse 选项 来 进行 逆 回 转换 : 
native2ascii -reverse Myfile.temp Myfile.java 
可 以 用 -encoding 选项 指定 为 一 种 编码 。 


native2ascii -encoding UTF-8 Myfile.java Myfile.temp 


7.8 ARB 


ASHE — TO INS, AY BE 23 TS AP AA E A tk BY As 8 Ss BS 
翻译 。 为 了 能 灵活 地 完成 这 项 任务 ， 你 会 希望 在 外 部 定义 消息 字符 串 ， 通常 称 之 为 资源 
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(resource)。 翻 译 人 员 不 需要 接触 程序 源 代码 就 可 以 很 容易 地 编辑 资源 文件 。 
在 Java 中 ， 你 要 使 用 属性 文件 来 设 定 字符 串 资源 ， 并 为 其 他 类 型 的 资源 实现 相应 的 类 。 


注意 : Java 技术 资源 和 Windows 和 Macintosh 资源 不 同 。Macintosh 或 Windows 可 执行 
文件 在 程序 代码 以 外 的 地 方 存储 类 似 菜单 、 对 话 框 、 图 标 和 消息 这 样 的 资源 。 资 源 编辑 
器 能 够 在 不 影响 程序 代码 的 情况 下 检查 并 更 新 这 些 资源 。 


注意 : BIH 13 SMART JAR 文件 资源 的 概念 ， 以 及 为 何 数据 文件 、 声 音 和 图 片 可 以 被 存 
放 在 JAR 文件 中 。Class 类 的 getResource 方法 可 以 找到 相应 的 文件 ， 打 开 它 并 返回 资源 
的 URL。 通 过 将 文件 放置 到 JAR 文件 中 ， 你 就 将 查找 这 些 资 源 文 件 的 工作 留 给 了 类 的 加 载 
器 去 处 理 ， 加 载 器 知道 如 何 定位 JAR 文件 中 的 项 。 但是， 这 种 机 制 不 支持 locale。 


7.8.1 定位 资源 包 


当 本 地 化 一 个 应 用 时 ， 会 产生 很 多 资源 包 (resource bundle)。 每 一 个 包 都 是 一 个 属性 文 
件 或 者 是 一 个 描述 了 与 locale 相关 的 项 的 类 (比如 消息 、 标 签 等 )。 对 于 每 一 个 包 ， 都 要 为 所 
有 你 想 要 支持 的 locale 提供 相应 的 版 本 。 

需要 对 这 些 包 使 用 一 种 统一 的 命名 规则 。 例 如 ， 为 德国 定义 的 资源 放 在 一 个 名 为 “ 包 名 
-de_DE ”的 文件 中 ， 而 为 所 有 说 德语 的 国家 所 共享 的 资源 则 放 在 名 为 “ 包 名 _de ”的 文件 
中 。 一般 来 说 ， 使 用 

包 和 名 _ Ba _ AK 
来 命名 所 有 和 国家 相关 的 资源 ， 使 用 

HA Wa 
来 命名 所 有 和 语言 相关 的 资源 。 最 后 ， 作 为 后 备 ， 可 以 把 默认 资源 放 到 一 个 没有 后 级 的 文件 中 。 

可 以 用 下 面 的 命令 加 载 一 个 包 

ResourceBundle currentResources = ResourceBundle.getBundle(bundleName, currentLocale) ; 


getBundle 方 法 试图 加 载 匹 配 当 前 locale 定 义 的 语言 和 国家 的 包 。 如 果 失 
败 ， 通 过 依次 放弃 国家 和 语言 来 继续 进行 查找 ， 然 后 同样 的 查找 被 应 用 于 默认 的 
locale， 最 后 ， 如 果 还 不 行 的 话 就 去 查看 默认 的 包 文 件 ， 如 果 这 也 失败 了 ， 则 抛 出 一 个 
MissingResourceException 异常 。 

这 就 是 说 ，getBundle 方法 会 试图 加 载 以 下 的 包 。 

Ms ““tiLocaleMis#aA 4iflLocalemBRX 4H Locale HEA 

A “ffLocale Mia _ 4if Locale WHK 

Hs “Hi Locale MRA 

Hs Bt Locale KWRA MU Locale KWAK Ri Locale nee 

BE Bu Locale KiF _ Rik Locale HHK 

Hs BU Locale KRA 

包 和 名 
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一 日 getBundle 方 法 定位 了 一 个 包 ， 比 如 ， 包 名 _de_DE， 它 还 会 继续 查找 包 名 _de 和 
包 名 这 两 个 包 。 如 果 这 些 包 也 存在 ， 它 们 在 资源 层次 中 就 成 为 了 包 名 _de_DE 的 父 包 。 以 后 ， 
当 查 找 一 个 资源 时 ， 如 果 在 当前 包 中 没有 找到 ， 就 去 查找 其 父 包 。 就 是 说 ， 如 果 一 个 特定 的 
资源 在 当前 包 中 没有 被 找到 , 比如 ， 某 个 特定 资源 在 包 和 名 _de_DE 中 没有 找到 ， 那 么 就 会 去 查 
WEA de MEA. 

这 是 一 项 非常 有 用 的 服务 ， 如 果 手 工 来 编写 将 会 非常 麻烦 。Java 编程 语言 的 资源 包机 制 
会 自动 定位 与 给 定 的 locale 匹配 得 最 好 的 项 。 可 以 很 容易 地 把 越 来 越 多 的 本 地 化 信息 加 到 已 
有 的 程序 中 : 你 需要 做 的 只 是 增加 额外 的 资源 包 。 
注意 ; 我 们 简化 了 对 资源 包 查 找 的 讨论 。 如 果 Locale 中 包含 脚本 或 变 体 ， 那 么 查找 就 

会 变 得 复杂 得 多 。 可 以 查看 ResoureBundle.Control.getCandidateLocales 方 法 

的 文档 以 了 解 其 细节 。 


@ 提示 : 不 需要 把 你 的 程序 的 所 有 资源 都 放 到 同一 个 包 中 。 可 以 用 一 个 包 来 存放 按钮 标签 ， 
用 另 一 个 包 存 放 错 误 消 息 等 。 


7.8.2 属性 文件 

对 字符 串 进 行 国际 化 是 很 直接 的 ， 你 可 以 把 所 有 字符 串 放 到 一 个 属性 文件 中 ， 比 如 
MyProgramSstrings.properties， 这 是 一 个 每 行 存放 一 个 键 -~ 值 对 的 文本 文件 。 典 型 的 属 
性 文件 看 起 来 就 像 这 样 : 


computeButton=Rechnen 
colorName=black 
defaul tPaperSize=210x297 


然后 你 就 像 上 一 节 描 述 的 那样 命名 你 的 属性 文件 ， 例 如 ， 


MyProgramStrings.properties 
MyProgramStrings_en.properties 
MyProgramStrings_de_DE.properties 


你 可 以 直接 加 载 包 ， 如 

ResourceBundle bundle = ResourceBundle.getBundle("MyProgramStrings", locale); 
要 查找 一 个 具体 的 字符 串 ， 可 以 调用 

String computeButtonLabel = bundle.getString("computeButton") ; 

QO 警告 : 存储 属性 的 文件 都 是 ASCII 文件 。 如 果 你 需要 将 Unicode 字符 放 到 属性 文件 中 ， 那 
么 请 用 \Uxxxx 编码 方式 对 它们 进行 编码 。 比 如 ， 要 设 定 “colorName=Grin”， 可 以 使 用 
colorName=Gr\u00FCn 
你 可 以 使 用 native2ascii 工具 来 产生 这 些 文件 。 

7.8.3 fx 


为 了 提供 字符 串 以 外 的 资源 ， 需 要 定义 类 ， 它 必需 扩展 自 ResourceBundle 类 。 应 该 使 


if 
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用 标准 的 命名 规则 来 命名 你 的 类 ， 比 如 


MyProgramResources. java 
MyProgramResources_en. java 
MyProgramResources_de_DE.java 


你 可 以 使 用 与 加 载 属性 文件 相同 的 get Bundle 方法 来 加 载 这 个 类 : 


ResourceBundle bundle = ResourceBundle.getBundle("MyProgramResources", locale); 


O 警告 : 当 搜索 包 时 ， 如 果 在 类 中 的 包 和 在 属性 文件 中 的 包 中 都 存在 匹配 ， 优 先 选择 类 中 的 包 。 


每 一 个 资源 包 类 都 实现 了 一 个 查询 表 。 你 需要 为 每 一 个 你 想 定 位 的 设置 都 提供 一 个 关键 
字 字 符 串 ， 使 用 这 个 字符 串 来 提取 相应 的 设置 。 例 如 ， 


Color backgroundColor = (Color) bundle,get0bject( backgroundColor ) ; 
double[] paperSize = (double[]) bundle.getObject("defaultPaperSize") ; 


实现 资源 包 类 的 最 简单 方法 就 是 继承 ListResourceBundle 4, ListResourceBundle 
让 你 把 所 有 资源 都 放 到 一 个 对 象 数 组 中 并 提供 查找 功能 。 要 遵循 以 下 的 代码 框架 : 


public class bundleName_language_country extends ListResourceBundle 


{ 
private static final 0bject[] [] contents = 
{ 
{ key;, values }, 
{ key, value F 
} 
public Object[][] getContents() { return contents; } 
例如 ， 
public class ProgramResources_de extends ListResourceBundle 
{ 
private static final Object[][] contents = 
{ "backgroundColor", Color.black }, 
{ "defaultPaperSize", new double[] { 210, 297 } } 
} 
public Object[][] getContents() { return contents; } 
} 
public class ProgramResources_en_US extends ListResourceBundle 
{ 


private static final Object[][] contents = 


{ "backgroundColor", Color.blue }, 
{ "defaultPaperSize", new double[] { 216, 279 } } 


} 
public Object[][] getContents() { return contents; } 


注意 : 纸 的 尺寸 是 以 毫米 为 单位 给 出 的 。 在 地 球 上 ， 除 了 加 拿 大 和 美国 ， 其 他 地 区 的 人 
都 使 用 ISO 216 规格 的 纸 。 更 多 信息 见 http://www.cl.cam.ac.uk/~mgk25/iso-paper.html。 
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或 者 ， 你 的 资源 包 类 可 以 扩展 ResourceBundle 类 。 然 后 需要 实现 两 个 方法 ， 一 是 枚 举 
所 有 键 ， 二 是 用 给 定 的 键 查找 相应 的 但 : 


Enumeration<String> getKeys() 
Object handleGet0bject(String key) 


ResourceBundle 类 的 getObject 方法 会 调用 你 提供 的 handleGetObject 方法 。 








e static ResourceBundle getBundle(String baseName, Locale loc) 


e static ResourceBundle getBundle(String baseName ) 
在 给 定 的 locale 或 默认 的 locale 下 以 给 定 的 名 字 加 载 资源 绑 定 类 和 它 的 父 类 。 如 采 
资源 包 类 位 于 一 个 Java 包 中 ， 那 么 类 的 名 字 必 须 包 含 完 整 的 包 名 ， 例如“ int1. 
ProgramResources”。 资 源 包 类 必须 是 public 的 ， 这 样 getBundle 方法 才能 访问 它们 。 
e Object getObject(String name) 
从 资源 包 或 它 的 父 包 中 查找 一 个 对 象 。 
e String getString(String name) 
从 资源 包 或 它 的 父 包 中 查找 一 个 对 象 并 把 它 转型 成 字符 串 。 
e String[] getStringArray(String name) 
从 资源 包 或 它 的 父 包 中 查找 一 个 对 象 并 把 它 转型 成 字符 串 数 组 。 
e Enumeration<String> getKeys() 
返回 一 个 枚 举 对 象 ， 枚 举 出 资源 包 中 的 所 有 键 ， 也 包括 父 包 中 的 键 。 
e Object handleGetObject(String key) 
如 果 你 要 定义 自己 的 资源 查找 机 制 ， 那 么 这 个 方法 就 需要 被 覆 写 ， 用 来 查找 与 给 定 的 
键 相 关联 的 资源 的 值 。 


7.9 一 个 完整 的 例子 


在 这 一 节 中 ， 我 们 使 用 本 章 中 的 内 容 来 对 退休 人 金 计算 器 小 程序 进行 本 地 化 ， 这 个 小 程序 
可 以 计算 你 是 否 为 退休 存 够 了 钱 ， 你 需要 输入 年 岭 ， 每 个 月 存 多 少 钱 等 信息 (参见 图 7-4 )。 

文本 区 和 图 表 显 示 每 年 退休 基金 中 的 余额 。 如 果 你 后 半生 的 退休 金 余 额 变 成 负数 ， 并 且 
表 中 的 数据 条 在 x- 轴 以 下 ， 你 就 需要 做 些 什 么 了 ; 例如 ， 存 更 多 的 钱 、 推 迟 退 休 、 早 点 死 或 
变 得 更 年 轻 。 

这 个 退休 计算 器 可 以 在 三 种 locale 下 工作 (英语 、 德 语 和 中 文 )。 下 面 是 进行 国际 化 时 的 
一 些 要 点 : 

e 标签 、 按 钮 和 消息 被 翻译 成 德语 和 中 文 。 你 可 以 在 RetireResources_de，Retire 
Resources_zh 中 找到 它们 。 英 语 作 为 后 备 ， 见 RetireResources 文件 。 为 了 产生 中 文 
消息 ， 我 们 首先 用 中 文 Windows 上 的 记事 本 来 编写 文件 ， 然 后 用 native2ascii 来 将 字 
符 转换 成 Unicode。 : 
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e 当 locale 改变 时 ， 我 们 重 置 标签 并 格式 化 文本 框 中 的 内 容 。 

o 文本 域 以 本 地 格式 处 理 数字 、 货 币值 和 百分数 。 

e 计算 域 使 用 MessageFormat。 格 式 字 符 串 被 存储 在 每 种 语言 的 资源 包 中 。 
o 为 了 说 明 的 确 可 行 ， 我 们 按照 用 户 选 择 的 语言 为 条 柱 图 使 用 不 同 的 颜色 。 
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程序 清单 7-5 到 程序 清单 7-8 显示 了 代码 ， 而 程序 清单 7-9 到 程序 清单 7-11 是 本 地 化 
的 字符 串 的 属性 文件 。 图 7-5 和 图 7-6 分 别 显 示 了 在 德语 和 中 文 下 的 输出 。 为 了 显示 中 文 ， 
请 确认 你 已 经 安装 并 在 Java 运行 环境 中 配置 了 中 文字 体 。 否 则 ， 所 有 的 中 文字 符 将 会 显示 


“missing character” tp. 
re Applet Viewer: Retire.class 


Sprache 
forherige Ersparnisse|0,00 € 
jetziges Alter)35 





: 555.397, 11 
: 520.166,96 
: 483.175,31 
: 444, 334,08 
: 403.550,78 
: 360.728,32 

315.764,74 


f | | ih EEI I Bii : : 268.552,97 
由 AEA A E EAA anil Alter: : 218.980, 62 
ccf UU UU anne : : : 166.929,65 


: 112.276,14 

; 54.889,94 € 
: -5.365,56 € 
: -68.633,84 € 


mh h A Ah A MH h Hh OH h MH A 





图 7-5 使 用 德语 的 退休 金 计算 器 
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图 7-6 使 用 中 文 的 退休 金 计 算 融 





package retire; 


import java.awt.*; 
import java.awt.geom.*; 
import java. text.*; 
import java.util.*; 


import javax.swing.*; 


wo o> N Dm wo Se WON e 


/** 
* This program shows a retirement calculator. The UI is displayed in English, German, and 
* Chinese. 
* @ersion 1.24 2016-05-06 
14 * @author Cay Horstmann 
这 于/ 
16 public class Retire 
uv { 
1 public static void main(String[] args) 
19 { 
20 EventQueue.invokeLater(() -> 
21 { 
22 JFrame frame = new RetireFrame() ; 
23 frame. setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE) ; 
24 frame. setVisible(true) ; 


25 Dy 


e 和 
wo re e 一 


29 Class RetireFrame extends JFrame 


30 { 
1 private JTextField savingsField = new JTextField(10); 


wa 
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private JTextField contribField = new JTextField(10); 

private JTextField incomeField = new JTextField(10); 

private JTextField currentAgeField = new JTextField(4); 
private JTextField retireAgeField = new JTextField(4); 
private JTextField deathAgeField = new JTextField(4); 

private JTextField inflationPercentField = new JTextField(6); 
private JTextField investPercentField = new JTextField(6); 
private JTextArea retirelext = new JTextArea(10, 25); 

private RetireComponent retireCanvas = new RetireComponent() ; 
private JButton computeButton = new JButton(); 

private JLabel languageLabel = new JLabel(); 

private JLabel savingsLabel = new JLabel(); 

private JLabel contribLabel = new JLabel (); 

private JLabel incomeLabel = new JLabel(); 

private JLabel currentAgeLabel = new JLabel(); 

private JLabel retireAgeLabel = new JLabel(); 

private JLabel deathAgeLabel = new JLabel (); 

private JLabel inflationPercentLabel = new JLabel(); 

private JLabel investPercentLabel = new JLabel(); 

private RetireInfo info = new RetireInfo(); 

private Locale[] locales = { Locale.US, Locale.CHINA, Locale.GERMANY }; 
private Locale currentLocale; 

private JComboBox<Locale> localeCombo = new LocaleCombo(locales) ; 
private ResourceBundle res; 

private ResourceBundle resStrings; 

private NumberFormat currencyFmt; 

private NumberFormat numberFmt; 

private NumberFormat percentFmt; 


public RetireFrame() 

{ 
setLayout (new GridBagLayout()) ; 
add(languageLabel, new GBC(0, 0).setAnchor (GBC. EAST)) ; 
add(savingsLabel, new GBC(0, 1).setAnchor(GBC.EAST)) ; 
add(contribLabel, new GBC(2, 1).setAnchor (GBC. EAST)) ; 
add(incomeLabel, new GBC(4, 1).setAnchor (GBC. EAST)); 
add(currentAgeLabel, new GBC(0, 2).setAnchor(GBC.EAST)) ; 
add(retireAgeLabel, new GBC(2, 2).setAnchor (GBC. EAST)) ; 
add(deathAgeLabel, new GBC(4, 2).setAnchor(GBC. EAST)) ; 
add(inflationPercentLabel, new GBC(0, 3).setAnchor(GBC.EAST)) ; 
add(investPercentLabel, new GBC(2, 3).setAnchor(GBC. EAST) ) ; 
add(localeCombo, new GBC(1, 0, 3, 1)); 
add(savingsField, new GBC(1, 1).setWeight(100, 0).setFil] (GBC.HORIZONTAL)) ; 
add(contribField, new GBC(3, 1).setWeight(100, 0).setFil] (GBC.HORIZONTAL)) ; 
add(incomeField, new GBC(5, 1).setWeight(100, 0).setFil] (GBC.HORIZONTAL)) ; 
add(currentAgeField, new GBC(1, 2).setWeight(100, 0).setFil] (CBC.HORIZONTAL)) ; 
add(retireAgeField, new GBC(3, 2).setWeight(100, 0).setFill (GBC.HORIZONTAL)) ; 
add(deathAgeField, new GBC(5, 2).setWeight(100, 0).setFill (GBC.HORIZONTAL)) ; 
add(inflationPercentField, new GBC(1, 3).setWeight(100, 0).setFill (GBC.HORIZONTAL)) ; 
add(investPercentField, new GBC(3, 3).setWeight(100, 0).setFill (GBC.HORIZONTAL)) ; 
add(retireCanvas, new GBC(0, 4, 4, 1).setWeight(100, 100).setFil] (GBC.BOTH)); 
add(new JScrollPane(retirelext), new GBC(4, 4, 2, 1).setWeight(0, 100).setFil1(GBC.BOTH)); 


computeButton.setName("computeButton’) ; 


ee 
H 
“~ 
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} 


/** 
* Sets the current locale. 
* @param locale the desired locale 
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computeButton.addActionListener(event -> 


getInfo(); 
updateData() ; 
updateGraph() ; 


}); 
add(computeButton, new GBC(5, 3)); 


retireText.setEdi table(fal se) ; 
retireText, setFont (new Font("Monospaced", Font.PLAIN, 10)); 


info. setSavings (0) ; 

info. setContrib(9000) ; 

info. setIncome (60000) ; 

info. setCurrentAge(35) ; 

info. setReti reAge(65) ; 
info.setDeathAge(85) ; 
info.setInvestPercent (0.1); 
info.setInflationPercent (0.05); 


int localeIndex = 0; // US locale is default selection 
for (int i = 0; 1 < locales.length; 1++) 
// if current locale one of the choices, select it 
if (getLocale().equals(locales[i])) localeIndex = i; 
setCurrentLocale(locales[localeIndex]) ; 


localeCombo.addActionListener(event -> 
{ 
setCurrentLocale((Locale) localeCombo.getSelectedItem()) ; 
validate() ; 
}); 
pack() ; 


public void setCurrentLocale(Locale locale) 


{ 


currentLocale = locale; 
localeCombo.setLocale(currentLocale) ; 
localeCombo. setSelectedItem(currentLocale) ; 


res = ResourceBundle.getBundle("retire.RetireResources", currentLocale) ; 
resStrings = ResourceBundle.getBundle("retire.RetireStrings", currentLocale) ; 
currencyFmt = NumberFormat.getCurrencyInstance(currentLocale) ; 

numberFmt = NumberFormat. getNumberInstance(currentLocale) ; 

percentFmt = NumberFormat .getPercentInstance(currentLocale) ; 


updateDisplay(); 
updateInfo() ; 
updateData() ; 
updateGraph() ; 
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/* 


$ 


* Updates all labels in the display. 
wi 
public void updateDisplay() 


{ 


} 


/* 


* 


languageLabel . setText (resStrings.getString("language")) ; 

savingsLabel .setText(resStrings.getString("savings")); 

contribLabel .setText(resStrings.getString("contrib")); 

incomeLabel .setText(resStrings.getString("income")) ; 

currentAgeLabel .setText(resStrings.getString("currentAge')) ; 

reti reAgeLabel .setText(resStrings.getString("retireAge')) ; 

deathAgeLabel . setText (resStrings.getString("deathAge")) ; 
inflationPercentLabel .setText(resStrings.getString("inflationPercent")); 
investPercentLabel .setText (resStrings.getString("investPercent")); 
computeButton. setText (resStrings.getString("computeButton")) ; 


* Undates the information in the text fields. 


* 


public void updateInfo() 


{ 


} 


/* 


* 


SavingsField.setText(currencyFmt. format (info.getSavings())); 
contribField.setText(currencyFmt. format (info.getContrib())); 
incomeField.setText(currencyFmt. format (info. getIncome())) ; 
currentAgeField.setText(numberFmt. format (info.getCurrentAge())) ; 
retireAgeField.setText (numberFmt. format (info. getReti reAge())) ; 
deathAgeField.setText (numberFmt. format (info.getDeathAge())) ; 
investPercentField.setText(percentFmt. format (info.getInvestPercent())); 
inflationPercentField.setText(percentFmt. format (info. getInflationPercent())); 


* Updates the data displayed in the text area. 


* 


public void updateData() 


{ 


/* 


* 
* 


* 


/ 


retireText.setText(""); 

MessageFormat retireMsg = new MessageFormat("") ; 
retireMsg.setLocale(currentLocale) ; 
retireMsg.applyPattern(resStrings.getString(“retire')) ; 


for (int i = info.getCurrentAge(); 1 <= info.getDeathAge(); i++) 
Object[] args = { 1, info.getBalance(i) }; 


retirelext.append(retireMsg.format(args) + "\n"); 


} 


Updates the graph. 
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194 public void updateGraph() 


is { 

196 retireCanvas.setColorPre((Color) res.getObject("colorPre")) ; 

197 retireCanvas.setColorGain((Color) res.getObject("colorGain")) ; 

198 retireCanvas.setColorLoss((Color) res.getObject("colorLoss")) ; 

199 retireCanvas.setInfo(info) ; 

200 repaint(); 

201 } 

202 

203 /** 

204 * Reads the user input from the text fields. 

205 */ 

206 public void getInfo() 

27 1{ 

208 try 

209 { 

210 info.setSavings(currencyFmt .parse(savingsField.getText()).doubleValue()); 
211 info, setContrib(currencyFmt, parse(contribField. getText()).doubleValue()); 
212 info. setIncome(currencyFmt.parse(incomeField.getText()).doubleValue()) ; 
213 info.setCurrentAge(numberFmt .parse(currentAgeField.getText()).intValue()); 
214 info. setReti reAge(numberFmt.parse(retireAgeField.getText()).intValue()) ; 
215 info. setDeathAge(numberFmt. parse (deathAgeField.getText()).intValue()); 

216 info. setInvestPercent (percentFmt. parse(investPercentField.getText()) .doubleValue()) ; 
217 info.setInflationPercent ( 

218 percentFmt.parse(inflationPercentField.getText()).doubleValue()); 
219 

220 catch (ParseException ex) 

221 { 

222 ex. printStackTrace() ; 

223 } 

224 } 

225 } 

226 

27 /** 

28 * The information required to compute retirement income data. 

29 */ 

230 class RetireInfo 

231 { 


232 private double savings; 

233 private double contrib; 

234 private double income; 

235 private int currentAge; 

236 private int retiredAge; 

237 private int deathAge; 

238 private double inflationPercent; 

239 private double investPercent; 

240 private int age; 

241 private double balance; 

242 

23 / 

244 * Gets the available balance for a given year. 

245 * @param year the year for which to compute the balance 
246 * @return the amount of money available (or required) in that year 
247 */ 


‘ 
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248 public double getBalance(int year) 


249 f 

250 if (year < currentAge) return 0; 

251 else if (year == currentAge) 

252 { 

253 age = year; 

254 balance = savings; 

255 return balance; 

256 } 

257 else if (year == age) return balance; 

258 if (year != age + 1) getBalance(year - 1); 
259 age = year; 

260 if (age < retireAge) balance += contrib; 
261 else balance -= income; 

262 balance = balance * (1 + (investPercent - inflationPercent)); 
263 return balance; 

264 } 

265 

266  /** 


267 * Gets the amount of prior savings. 
268 * @return the savings amount 


269 */ 

270 public double getSavings() 
21 f{ 

272 return savings; 

273 o} 

274 

275  /** 


276 * Sets the amount of prior savings. 
277 * @param newValue the savings amount 


278 */ 

279 public void setSavings(double newValue) 
20 d 

281 Savings = newValue; 

282} . 

283 

284  /** 


285 * Gets the annual contribution to the retirement account. 
286 * @return the contribution amount 


287 */ 

288 public double getContribQ) 
289 {f 

290 return contrib; 

291 O} 

292 

293  [** 


294 * Sets the annual contribution to the retirement account. 
295 * @param newValue the contribution amount 


296 */ 

297 public void setContrib(double newValue) 
28 二 

299 contrib = newValue; 


300 } 
301 
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319 
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/[** 
* Gets the annual income. 


* @return the income amount 
‘| 


public double getIncome() 
{ 


return income; 


} 


/** 
* Sets the annual income. 
* @param newValue the income amount 


*/ 
public void setIncome(double newValue) 
{ 
income = newValue; 
} 
[** 


* Gets the current age. 
* @return the age 
| 
public int getCurrentAge() 
{ 
return currentAge; 


} 
/** 


* Sets the current age. 

* Qparam newValue the age 

gi 
public void setCurrentAge(int newValue) 
{ 


currentAge = newValue; 


} 
/** 


* Gets the desired retirement age. 
* @return the age 
| 

public int getRetireAge() 

{ 


return retireAge; 


} 
[** 


* Sets the desired retirement age. 
* @param newValue the age 
ji 
public void setRetireAge(int newValue) 


{ 


retireAge = newValue; 


} 
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/** 
* Gets the expected age of death. 
* @return the age 
"7 
public int getDeathAge() 
{ 
return deathAge; 
} 


/** 

* Sets the expected age of death. 

* @param newValue the age 

*/ 

public void setDeathAge(int newValue) 
{ 


deathAge = newValue; 


} 
/** 


* Gets the estimated percentage of inflation. 
* @return the percentage 
eit 

public double getInflationPercent() 

{ 


return inflationPercent; 


} 
/** 


* Sets the estimated percentage of inflation. 
* @aram newValue the percentage 


*/ 
public void setInflationPercent(double newValue) 
{ 
inflationPercent = newValue; 
} 
/** 


* Gets the estimated yield of the investment. 
* @return the percentage 
*/ 

public double getInvestPercent() 

{ 


return investPercent; 


} 
/** 


* Sets the estimated yield of the investment. 
* @aram newValue the percentage 


人 
public void setInvestPercent(double newValue) 
{ 
investPercent = newValue; 
} 
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41 /** 

412 * This component draws a graph of the investment result. 
413 */ 

14 Class RetireComponent extends JComponent 

415 { 

416 private static final int PANEL_WIDTH = 400; 

a7 private static final int PANEL_HEIGHT = 200; 

a private static final Dimension PREFERRED SIZE = new Dimension(800, 600) ; 
49 private RetireInfo info = null; 

420 private Color colorPre; 

41 private Color colorGain; 

422 private Color colorLoss; 

423 

a4 public RetireComponent () 

nas f{ 

426 setSize(PANEL_WIDTH, PANEL_HEICHT) ; 

n7 } 

428 

429  /** 

430 * Sets the retirement information to be plotted. 
431 * @aram newInfo the new retirement info 

432 */ 

433 public void setInfo(RetireInfo newInfo) 

434 


-人 


435 info = newInfo; 
436 repaint() ; 
437 o} 


438 
439 public void paintComponent (Graphics g) 


wo { 

441 Graphics2D g2 = (Graphics2D) g; 

442 if (info == null) return; 

443 

444 double minValue = 0; 

445 double maxValue = 0; 

446 int 1; 

447 for (i = info.getCurrentAge(); i <= info.getDeathAge(); i++) 
448 

449 double v = info.getBalance(i) ; 
450 if (minValue > v) minValue = v; 
451 if (maxValue < v) maxValue = v; 
452 

453 if (maxValue == minValue) return; 


454 


455 int barWidth = getWidth() / (info.getDeathAge() - info.getCurrentAge() + 1); 


456 double scale = getHeight() / (maxValue - minValue) ; 

457 

458 for (i = info.getCurrentAge(); i <= info.getDeathAge(); i++) 
459 { 

460 int x1 = (i - info.getCurrentAge()) * barWidth + 1; 

461 int yl; 

462 double v = info.getBalance(i) ; 

463 int height; 

TE int yOrigin = (int) (maxValue * scale); 


1 
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465 
466 if (v >= 0) 

467 { 

468 yl = (int) ((maxValue - v) * scale); 

469 height = yOrigin - yl; 

470 

471 else 

472 { 

473 yl = yOrigin; 

474 height = (int) (-v * scale); 

475 

476 

477 if (1 < info.getRetireAge()) g2.setPaint(colorPre) : 
478 else if (v >= 0) g2.setPaint(colorGain) ; 

479 else g2.setPaint(colorLoss) ; 

480 Rectangle2D bar = new Rectangle2D.Double(x1, yl, barWidth - 2, height); 
481 g2.fi11 (bar); 

482 g2.setPaint(Color.black) ; 

483 g2.draw(bar) ; 

484 } 

485} 

486 

487  /** 

488 * Sets the color to be used before retirement. 

489 * @param color the desired color 

490 */ 

491 public void setColorPre(Color color) 

492 

493 colorPre = color; 

494 repaint(); 

495} 

496 

497  /** 

498 * Sets the color to be used after retirement while the account balance is positive. 
499 * @param color the desired color 

500 */ 

501 public void setColorGain(Color color) 

s02 { 

503 colorGain = color; 

504 repaint() ; 

505 

506 

soz /** 

508 * Sets the color to be used after retirement when the account balance is negative. 
509 * @param color the desired color 

510 a i 

51 public void setColorLoss(Color color) 

512 

513 colorLoss = color; 

514 repaint(); 

515} 

516 

517 public Dimension getPreferredSize() { return PREFERRED SIZE: } 
518 } 
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1 package retire; 
2 
3 import java.awt.*; 


4 
5 /** 

6 * These are the English non-string resources for the retirement calculator. 
7 * @ersion 1.21 2001-08-27 

8 * @author Cay Horstmann 

9 */ 

10 public class RetireResources extends java.util.ListResourceBundle 

u { 

12 private static final Object[][] contents = { 

3 // BEGIN LOCALIZE 


14 { "colorPre", Color.blue }, { "colorGain", Color.white }, { "colorLoss", Color.red } 
15 // END LOCALIZE 
6 © Sy 


18 public Object{] [] getContents() 
{ 


20 return contents; 





package retire; 


import java.awt.*; 


* These are the German non-string resources for the retirement calculator. 
* @ersion 1.21 2001-08-27 l 


* @author Cay Horstmann 


1 
2 
3 
4 
5 /** 
6 
7 
8 
9 */ 


10 public class RetireResources_de extends java.util.ListResourceBundle 


u { 
1 private static final Object[][] contents = { 
13- // BEGIN LOCALIZE 


14 { "colorPre", Color.yellow }, { "colorGain", Color.black }, { "colorLoss", Color.red } 
15 // END LOCALIZE 
Ce $ 


18 public Object{] {] getContents () 
{ 


20 return contents; 












1 package retire; 
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import java.awt.*: 


ar 

* These are the Chinese non-string resources for the retirement calculator. 
* @version 1.21 2001-08-27 

* @author Cay Horstmann 

人 

10 public class RetireResources_zh extends java.uti].ListResourceBundle 

u { 

12 private static final Object[][] contents = { 

3 // BEGIN LOCALIZE 


O © N FO wm mow N 


14 { "colorPre", Color.red }, { "colorGain", Color.blue }, { "colorLoss", Color.yellow } 
15 // END LOCALIZE 
6 }; 


18 public Object[][] getContents () 
{ 


20 return contents; 









1 language=Language 
2 computeButton=Compute 
3 Savings=Prior Savings 
4 contrib=Annual Contribution 

5 income=Retirement Income 

6 currentAge=Current Age 

7 retireAge=Retirement Age 

8 deathAge=Life Expectancy 

9 inflationPercent=Inflation 

10 investPercent=Investment Return 

11 retire=Age: {0,number} Balance: {1,number, currency} 


人 





language=Sprache 
computeButton=Rechnen 
Savings=Vorherige Ersparnisse 
contrib=]\u00e4hrliche Einzahlung 
income=Einkommen nach Ruhestand 
currentAge=Jetziges Alter 

reti reAge=Ruhestandsalter 
deathAge=Lebenserwartung 
inflationPercent=Inflation 

10 investPercent=Investitionsgewinn 
11 retire=Alter: {0,number} Guthaben: {1,number, currency} 


oo GD N mm Am A u N pja 








ono nt DOD n A uu N e 


{a {æ 
ke Oo 
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language=\u8bed\u8a00 
computeButton=\u8bal\u7b97 

Savings=\u65e2\u5b58 

contri b=\u6bcf\uSe74\u5b58\u91d1 

income=\u9000\u4f11\u6536\u5165 

currentAge=\u73b0\u9f84 

reti reAge=\u9000\u4f11\u5e74\u9F84 
deathAge=\u9884\u671F\uSbff\u547d 
inflationPercent=\u901a\u8d27\u81a8\u6da8 
investPercent=\u6295\u8d44\u62a5\u916c 

retire=\u5e74\u9f84: {0,number} \u603b\u7ed3: {1,number, currency} 





本 章 进 述 了 如 何 运用 Java 语言 的 国际 化 特性 。 你 可 以 使 用 资源 包 来 提供 多 种 语言 的 转 


译 ， 也 可 以 使 用 格式 器 和 排序 器 来 处 理 特定 locale 的 文本 。 


下 一 章 将 研究 脚本 编写 、 编 译 和 注解 处 理 。 





第 8 章 脚本 、 编 译 与 注解 处 理 


A Java 平 台 的 脚本 A 标准 注解 

A EAr API A 源码 级 注解 处 理 
全 使 用 注解 A 字 节 码 工程 

A 注解 语法 


本 划 将 介绍 三 种 用 于 人 处理 代码 的 技术 : 脚本 API 使 你 可 以 调用 诸如 JavaScript 和 Groovy 
这 样 的 脚本 语言 代码 ; 当 你 希望 在 应 用 程序 内 部 编译 Java 代码 时 ， 可 以 使 用 编译 器 API; 注 
解 处 理 器 可 以 在 包含 注解 的 Java 源 代码 和 类 文件 上 进行 操作 。 如 你 所 见 ， 有 许多 应 用 程序 
都 可 以 用 来 处 理 注解 ， 从 简单 的 诊断 到 “ 字 节 码 工程 ”， 后 者 可 以 将 字 节 码 插入 到 类 文件 中 ， 
甚至 可 以 插入 到 运行 程序 中 。 


8.1 Java 平台 的 脚本 


脚本 语言 是 一 种 通过 在 运行 时 解释 程序 文本 ， 从 而 避免 使 用 通常 的 编辑 / 编译 /链接 / 运 
行 循环 的 语言 。 脚 本 语言 有 许多 优势 : 

o 便于 快速 变更 ， 鼓 励 不 断 试验 。 

o 可 以 修改 运行 着 的 程序 的 行为 。 


o 文 持 程 序 用 户 的 定制 化 。 
慷 一 方面 ， 大 多 数 脚本 语言 都 缺乏 可 以 使 编写 复杂 应 用 受益 的 特性 ， 例 如 强 类 型 、 封 装 
和 模块 化 。 


因此 人 们 在 尝试 将 脚本 语言 和 传统 语言 的 优势 相 结合 。 脚 本 API 使 你 可 以 在 Java 平台 上 
实现 这 个 目的 ， 它 支持 在 Java 程序 中 对 用 JavaScript、Groovy、Ruby， 甚 至 是 更 奇异 的 诸如 
Scheme 和 Haskell 等 语言 编写 的 脚本 进行 调用 。 例 如 ，Renjin 项 目 ( www.renjin.org) 就 提供 
了 一 个 R 语言 的 Java 实现 和 相应 的 脚本 API 的 “引擎 "，R 语言 被 广泛 应 用 于 统计 编程 中 。 

在 下 面 的 小 节 中 ， 我 们 将 向 你 展示 如 何 为 某 种 特定 的 语言 选择 一 个 引擎 ， 如 何 执行 脚 
本 ， 以 及 如 何 利用 某 些 脚本 引擎 提供 的 先进 特性 。 


8.1.1 获取 脚本 引擎 


脚本 引擎 是 一 个 可 以 执行 用 某 种 特定 语言 编写 的 脚本 的 类 库 。 当 虚拟 机 启动 时 ， 它 会 
发 现 可 用 的 脚本 引擎 。 为 了 枚 举 这 些 引 警 ， 需 要 构造 一 个 ScriptEngineManager， 并 调用 
getEngineFactories 方法 。 可 以 向 每 个 引 敬 工厂 询问 它们 所 支持 的 引擎 名 、MIME 类 型 和 
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文件 扩展 名 。 表 8-1 显示 了 这 些 内 容 的 典型 值 。 


表 8-1 脚本 引擎 工厂 的 属性 


引擎 名 F MIME 类 型 文件 扩展 


application/javascript, application/ 
nashorn, Nashorn, js, JS, JavaScript, PP J pt, app 





Nashorn (包含 在 Java SE er NA Qi eomaséript ee text/javascript, text/ js 

Groovy groovy v0 groovy 

Renjin Renjin text/x-R R r, S, 5 
SISC Scheme sisc T scheme, sisc 


通常 ， 你 知道 所 需要 的 引擎 ， 因 此 可 以 直接 通过 名 字 、MIME 类 型 或 文件 扩展 来 请 求 它 ， 
例如 : 

ScriptEngine engine = manager .getEngineByName ("nashorn") ; 

Java SE 8 包含 一 个 Nashorn 版 本 ， 这 是 由 Oracle 开发 的 一 个 JavaScript 解释 项 。 可 以 通 
过 在 类 路 径 中 提供 必要 的 JAR 文件 来 添加 对 更 多 语言 的 支持 。 





e List<ScriptEngineFactory> getEngineFactories'( ) 


获取 所 有 发 现 的 引擎 工厂 的 列表 。 


eScriptEngine getEngineByName(String name ) 


eScriptEngine getEngineByExtension(String extension) 
e ScriptEngine getEngineByMimeType(String mimeType ) 
获取 给 定名 字 、 脚 本 文件 扩展 名 或 MIME 类 型 的 脚本 引擎 。 





ee 


e List<String> getNames() 

e List<String> getExtensions() 

e List<String> getMimeTypes() 

获取 该 工厂 所 了 解 的 名 字 、 脚 本 文件 扩展 名 和 MIME 类 型 。 


8.1.2 ”脚本 赋值 与 绑 定 
一 日 拥有 了 引擎 ， 就 可 以 通过 下 面 的 调用 来 直接 调用 脚本 : 


Object result = engine.eval (scriptString) ; 
如 果 脚 本 存储 在 文件 中 ， 那 么 需要 先 打开 一 个 Reader ， 然 后 调用 : 


Object result = engine.eval (reader) ; 


可 以 在 同一 个 引擎 上 调用 多 个 脚本 。 如 果 一 个 脚本 定义 了 变量 、 函 数 或 类 ， 那 么 大 多 数 
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引擎 都 会 保留 这 些 定义 ， 以 供 将 来 使 用 。 例 如 : 


engine.eval("n = 1728"); 
Object result = engine.eval("n + 1"); 


将 返回 1729, 


注意 : 要 想 知 道 在 多 个 线程 中 并 发 执行 脚本 是 否 安全 ， 可 以 调用 
Object param = factory.getParameter("THREADING"); 
其 返回 的 是 下 列 值 之 一 : 
e null: 并 发 执行 不 安全 。 
e "MULTITHREADED" : 并 发 执行 安全 。 一 个 线程 的 执行 效果 对 另外 的 线程 有 可 能 是 可 
视 的 。 
è "THREAD-ISOLATED": 除了 "MULTITHREADED" 之 外 ,会 为 每 个 线程 维护 不 同 的 
e"STATELESS": 除了 "THREAD-ISOLATED" 之 外 ， 脚 本 不 会 改变 变量 绑 定 。 


我 们 经 常 硕 望 能 够 向 引擎 中 添加 新 的 变量 绑 定 。 绑 定 由 名 字 及 其 关联 的 Java 对 象 构成 。 
例如 ， 考 虑 下 面 的 语句 : 


engine.put("k", 1728); 
Object result = engine.eval("k + 1"); 


脚本 代码 从 “引擎 作用 域 ” 中 的 绑 定 里 读 取 k 的 定义 。 这 一 点 非常 重要 ， 因 为 大 多 数 脚 
本 语言 都 可 以 访问 Java 对 象 ， 通 常 使 用 的 是 比 Java 语法 更 简单 的 语法 。 例 如 ， 


engine.put("b", new JButton()); 
engine.eval("b.text = '0k'"); 


反 过 来 ， 也 可 以 获取 由 脚本 语句 绑 定 的 变量 : 


engine.eval("n = 1728"); 
Object result = engine.get("n"); 


除了 引擎 作用 域 之 外 ， 还 有 全 局 作用 域 。 任 何 添 加 到 ScriptEngineManager 中 的 绑 定 
对 所 有 引擎 都 是 可 视 的 。 

除了 加 引擎 或 全 局 作用 域 添加 绑 定 之 外 ， 还 可 以 将 绑 定 收 集 到 一 个 类 型 为 Bindings 的 
对 象 中 ， 然 后 将 其 传递 给 eval 方法 : 


Bindings scope = engine.createBindings(); 
Scope.put("b", new JButton()); 
engine.eval (ScriptString, scope); 


如 采 绑 定 集 不 应 该 为 了 将 来 对 eval 方法 的 调用 而 持久 化 ,那么 这 么 做 就 很 有 用 。 


注意 : 你 可 能 希望 除了 引擎 作用 域 和 全 局 作用 域 之 外 还 有 其 他 的 作用 域 。 例 如 ，Web 容 
器 可 能 需要 请 求 作用 域 或 会 话 作 用 域 。 但 是 ， 这 需要 你 自己 去 解决 。 你 需要 实现 一 个 类 ， 
它 实 现 了 ScriptContext 接口 ， 并 管理 着 一 个 作用 域 集 合 。 每 个 作用 域 都 是 由 一 个 整 
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数 标识 的 ， 而 且 越 小 的 数字 应 该 越 先 被 搜索 。( 标 准 类 库 提 供 了 SimpleScriptContext 
类 ， 但 是 它 只 能 持 有 全 局 作用 域 和 引擎 作用 域 。) 






e Object eval(String script) 
e Object eval(Reader reader ) 
e Object eval(String script, Bindings bindings) 
e Object eval(Reader reader, Bindings bindings) 
对 由 字符 串 或 读 取 器 给 定 的 脚本 赋值 ， 并 服从 给 定 的 绑 定 。 
e Object get(String key) 
e void put(String key, Object value) 
在 引擎 作用 域内 获取 或 放置 一 个 绑 定 。 
e Bindings createBindings() 


创建 一 个 适合 该 引擎 的 空 Bindings WA. 








e Object get(String key) 
e void put(String key, Object value) 
在 全 局 作用 域内 获取 或 放置 一 个 绑 定 。 





e Object get(String key) 
e void put(String key, Object value) 
在 由 该 Bindings 对 象 表示 的 作用 域内 获取 或 放置 一 个 绑 定 。 


8.1.3 重 定向 输入 和 输出 


可 以 通过 调用 脚本 上 下 文 的 setReader 和 mee ter 方法 来 重 定向 脚本 的 标准 输入 和 
输出 。 例 如 ， 


StringWriter writer = new StringWriter() ; 
engine.getContext().setWriter(new PrintWriter(writer, true)); 


在 上 例 中 ， 任 何 用 JavaScript 的 print Al printin 函数 产生 的 输出 都 会 被 发 送 到 writer, 
setReader 和 setWriter 方法 只 会 影响 脚本 引擎 的 标准 输入 和 输出 源 。 例 如 ， 如 果 执 
行 下 面 的 JavaScript 代码 : 


printin("Hello"); 
java. lang. System.out.printIn(“World") ; 


则 只 有 第 一 个 输出 会 被 重 定 问 。 
Nashorn 引擎 没有 标准 输入 源 的 概念 ， 因 此 调用 setReader 没有 任何 效果 。 


I 


MZ Booas 
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e ScriptContext getContext() 
获得 该 引擎 的 默认 的 脚本 上 下 文 。 





eReader getReader() 


e void setReader(Reader reader) 

e Writer getWriter() 

e void setWriter(Writer writer) 

è Writer getErrorWriter() 

e void setErrorWriter(Writer writer) 


IER i E H TA AST A a OA FIE A paR BS a o 
8.1.4 调用 脚本 的 函数 和 方法 


在 使 用 许多 脚本 引擎 时 ， 都 可 以 调用 脚本 语言 的 函数 ， 而 不 必 对 实际 的 脚本 代码 进行 计 
算 。 如 果 人 允许 用 户 用 他 们 所 选择 的 脚本 语言 来 实现 服务 ， 那 么 这 种 机 制 就 很 有 用 了 。 

提供 这 种 功能 的 脚本 引擎 实现 了 Invocable 接口 。 特 别 是 ，Nashorn 引擎 就 是 实现 了 
Invocable 接口 。 

要 再 用 一 个 晒 数 ， 需 要 用 函数 名 来 调用 invokeFunction 方法 ， 函 数 名 后 面 是 函数 的 参数 : 

// Define greet function in JavaScript 

engine.eval("function greet(how, whom) { return how + ', ' + whom + '!' }"); 


// Call the function with arguments "Hello", "World" 
result = ((Invocable) engine) .invokeFunction("greet", "Hello", "World"); 


如 果 脚 本 语言 是 面向 对 象 的 ， 那 就 可 以 调用 : nvoke Method: 


// Define Greeter class in JavaScript 
engine.eval ("function Greeter(how) { this.how = how }"); 
engine.eval ("Greeter.prototype.welcome = " 

+ " function(whom) { return this.how + ', ' + whom + '!' }"); 


// Construct an instance 
Object yo = engine.eval ("new Greeter('Yo')"); 


// Call the welcome method on the instance 
result = ((Invocable) engine).invokeMethod(yo, "welcome", "World"); 


注意 : 关于 如 何 用 Java Script 定义 类 的 更 多 细节 ， 可 以 参阅 《 JavaScript—The Good 
Parts ), Douglas Grockford # (O’Reilly, 2008 ) 。 


注意 : 即使 脚本 引擎 没有 实现 Invocable 接口 ， 你 也 可 能 仍旧 可 以 以 一 种 独立 于 语言 的 
方式 来 调用 某 个 方法 。ScriptEngineFactory 类 的 getMethodCa11Syntax 方法 可 以 
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产生 一 个 字符 串 ， 你 可 以 将 其 传递 给 eval 方法 。 但 是 ， 所 有 的 方法 参数 必须 都 与 名 字 
绑 定 ， 尽 管 可 以 用 任意 值 调 用 invokeMethod, 


我 们 可 以 更 进一步 ， 让 脚本 引擎 去 实现 一 个 Java 接口 ， 然 后 就 可 以 用 Java- 方 法 调用 的 
语法 来 调用 脚本 函数 。 

其 细节 依赖 于 脚本 引擎 ， 但 是 典型 情况 是 我 们 需要 为 该 接口 中 的 每 个 方法 都 提供 一 个 隔 
数 。 例 如 ， 考 虑 下 面 的 Java 接口 : 


public interface Greeter 


{ 


String welcome(String whom) ; 


如 果 在 Nashorn PE LT AAA HY ee, ABA a ie Ph Be HORDE : 


// Define welcome function in JavaScript 
engine.eval ("function welcome(whom) { return ‘Hello, 


+ whom + '!' }"); 


// Get a Java object and call a Java method 
Greeter g = ((Invocable) engine) .getInterface(Greeter.class) ; 
result = g.welcome("World") ; 


在 面向 对 象 的 脚本 语言 中 ， 可 以 通过 相 匹 配 的 Java 接口 来 访问 一 个 脚本 类 。 例 如 ， 下 面 
的 代码 展示 了 如 何 使 用 Java 的 语法 来 调用 JavaScript 的 Simp1eGreeter 类 : 


Greeter g = ((Invocable) engine).getInterface(yo, Greeter.class); 
result = g.welcome("World"); 


总 之 ， 如 果 你 希望 从 Java 中 调用 脚本 代码 ， 同 时 又 不 想 因 这 种 脚本 语言 的 语法 而 受到 困 
Ht, BBA Invocable 接口 就 很 有 用 。 


NMR Tras A AEA Sa ATA EIn kaw CE 





e Object invokeFunction(String name, Object... parameters ) 


eObject invokeMethod(Object implicitParameter, String name, 
Object... explicitParameters ) 
用 给 定 的 名 字 调 用 函数 或 方法 ， 并 传递 给 定 的 参数 。 

e<T> T getInterface(Class<T> iface) 
返回 给 定 接口 的 实现 ， 该 实现 用 脚本 引擎 中 的 函数 实现 了 接口 中 的 方法 。 

e<T> T getInterface(Object implicitParameter, Class<T> iface) 


返回 给 定 接口 的 实现 ， 该 实现 用 给 定 对 象 的 方法 实现 了 接口 中 的 方法 。 
8.1.5 ”编译 脚本 


某 些 脚本 引擎 出 于 对 执行 效率 的 考虑 ， 可 以 将 脚本 代码 编译 为 某 种 中 间 格 式 。 这 些 引擎 
实现 了 Compilable 接口 。 下 面 的 示例 展示 了 如 何 编译 和 计算 包含 在 脚本 文件 中 的 代码 : 


Reader reader = new FileReader("myscript.js'); 
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CompiledScript script = null; 
if (engine implements Compilable) 
script = ((Compilable) engine).compile(reader) ; 


一 旦 该 脚本 被 编译 ， 就 可 以 执行 它 。 下 面 的 代码 将 会 在 编译 成 功 的 情况 下 执行 编译 后 的 
脚本 ， 如 果 引 擎 不 支持 编译 ， 则 执行 原始 的 脚本 。 


if (script != null) 
script.eval (); 

else 
engine.eval (reader) ; 


当然 ， 只 有 需要 重复 执行 时 ， 我 们 才 希 望 编译 脚本 。 





e CompiledScript compile(String script) 
e CompiledScript compile(Reader reader ) 


编译 由 字符 串 或 读 人 器 给 定 的 脚本 。 






e Object eval() 
e Object eval(Bindings bindings) 
对 该 脚本 计算 。 


8.1.6 ”一 个 示例 : 用 脚本 处 理 GUI 事件 


为 了 演示 脚本 API， 我 们 将 开发 一 个 样 例 程序 ， 它 允许 用 户 指定 使 用 他 们 所 选择 的 脚本 
语言 编写 的 事件 处 理 器 。 

让 我 们 看 看 程序 清单 8-1 中 的 程序 ， 它 可 以 将 脚本 添加 到 任意 的 框 体 类 中 。 默 认 情况 下 ， 
它 会 读 取 程序 清单 8-2 中 的 ButtonFrame 类 ，ButtonFrame 类 与 卷 工 中 介绍 的 事件 处 理 演 
示 程 序 类 似 ， 但 是 有 两 个 差异 : 

e 每 个 构件 都 有 其 自己 的 name 属性 集 。 

o 没有 任何 事件 处 理 器 。 

事件 处 理 器 是 在 属性 文件 中 定义 的 。 每 个 属性 定义 都 具有 下 面 的 形式 ; 


componentName. eventName = scriptCode 


例如 ， 如 果 选 择 使 用 JavaScript， 那 就 要 在 js .properties 文件 中 提供 事件 处 理 器 : 


yellowButton.action=panel ,background = java.awt.Color. YELLOW 
blueButton.action=panel ,background = java.awt.Color.BLUE 
redButton.action=panel .background = java.awt.Color.RED 


本 书 附带 的 代码 还 包括 用 于 Groovy, R 和 SISC Scheme 的 文件 。 
该 程序 以 加 载 在 命令 行 中 指定 的 语言 所 需 的 引擎 开始 ， 如 果 未 指定 语言 ， 则 使 用 
JavaScript。 然 后 ， 我 们 处 理 init .1anguage 脚本 ， 如 果 有 该 文件 的 话 。 这 对 R 语言 和 Scheme 
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语言 而 言 很 用， 因为 这 些 语 言 需要 某 些 麻 烦 的 初始 化 工作 ， 我 们 不 希望 在 每 个 事件 处 理 从 
的 脚本 中 都 包括 这 部 分 工作 。 

接 下 来 ， 我 们 递归 地 遍历 所 有 的 子 构件 ， 并 在 构件 映射 表 中 添加 绑 定 (名字 ， 对 象 )， 然 
后 ， 将 它们 添加 到 引擎 中 。 

然后 ， 我 们 读 和 人 1anguage .properties 文件 。 对 于 每 一 个 属性 ， 都 合成 其 事件 处 理 融 
代理 ,使 得 脚本 代码 得 以 执行 。 其 细节 有 些 技术 性 ， 如 果 你 希望 了 解 实现 的 细节 ， 请 参阅 
卷 1 第 6 章 有 关 代 理 的 小 节 。 但 是 ， 其 精髓 部 分 是 每 个 事件 处 理 絮 都 会 调用 下 面 的 方法 : 

engine.eval (scriptCode) ; 

让 我 们 详细 看 看 ye11owButton。 当 下 面 一 行 被 处 理 时 ， 

yel lowButton.action=panel .background = java.awt.Color. YELLOW 


我 们 找到 了 具有 “ye11owButton” 名 字 的 JButton 构件 ， 然 后 附着 一 个 ActionListener， 
它 拥有 actionPerformed 方法 ， 该 方法 将 执行 下 面 的 脚本 ， 如 果 该 脚本 是 用 Nashorn 执行 的 : 


panel .background = java.awt.Color. YELLOW 

引擎 包含 一 个 将 名 字 “pane1” 与 这 个 JPanel 对 象 绑 定 在 一 起 的 绑 定 。 当 事件 发 生 时 ， 
该 面板 的 setBackground 方法 就 会 执行 ， 并 且 其 颜色 也 会 改变 。 

只 需要 执行 下 面 的 命令 ， 就 可 以 运行 这 个 带 有 JavaScript 事件 处 理 器 的 程序 : 

java ScriptTest 

对 于 Groovy 处 理 器 ， 需 要 使 用 

java -classpath .:groovy/lib/\* ScriptTest groovy 


XE, groovy 是 Groovy 的 安装 目录 。 

对 于 R 的 Renjin 实现 ， 要 在 类 路 径 中 包含 Renjin Studio 的 JAR 文件 以 及 Renjin 脚本 引 
它们 都 可 以 在 www.renjin.org/downloads.html 处 获得 。 

要 试验 Scheme， 则 需要 从 http://sisc-scheme.org/ 下 载 SISC Scheme， 并 运行 : 


java -classpath .:sisc/*:jsr223-engines/scheme/build/scheme-engine.jar ScriptTest scheme 


其 中 sisc 是 SISC Scheme 的 安装 目录 ，jsr223-engines 是 包含 了 从 http://java.net/projects/ 
scripting 处 下 载 的 引擎 适 配 妖 的 目录 。 

这 个 应 用 演示 了 如 何在 Java GUI 编程 中 使 用 脚本 。 大 家 可 以 更 进一步 ， 用 XML 文件 来 
描述 GUI， 就 像 在 第 3 章 中 看 到 的 那样 。 然 后 我 们 的 程序 就 会 变 成 解释 器 ， 去 解释 那些 由 
XML 文件 定义 可 视 化 表示 以 及 用 脚本 语言 定义 行为 的 GUI。 请 注意 这 与 动态 HTML 页 面 或 
动态 服务 器 端 脚本 环境 之 间 的 相似 性 。 





1 package script; 
2 
3 import java.awt.*; 
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import java.beans.*: 

import java.io.*; 

import java.lang.reflect.*; 
import java.util.*; 

import javax.script.*; 
import javax.swing.*; 


/** 


* @ersion 1.02 2016-05-10 
* @author Cay Horstmann 


"i 


public class ScriptTest 


{ 


public static void main(String[] args) 


{ 


EventQueue.invokeLater(() -> 


{ 


try 


{ 


ScriptEngineManager manager = new ScriptEngineManager() ; 
String language; 

if (args.length == 0) 

{ 


System.out.println("Available factories: "); 
for (ScriptEngineFactory factory : manager.getEngineFactories()) 
System. out.println(factory.getEngineName()); 


language = "nashorn"; 


} 


else language = args [0]; 


final ScriptEngine engine = manager .getEngineByName (language) ; 
if (engine == null) 


System.err.println("No engine for " + language); 
System.exit(1); 
} 


final String frameClassName = args.length < 2 ? "buttons1.ButtonFrame" : args[1]; 
JFrame frame = (JFrame) Class. forName(frameC] assName) .newInstance() ; 

InputStream in = frame.getClass().getResourceAsStream("init." + language) ; 

if (in != null) engine.eval (new InputStreamReader(in)); 

Map<String, Component> components = new HashMap<>(); 

getComponentBindings (frame, components); 

components. forEach((name, c) -> engine.put(name, c)); 


final Properties events = new Properties(); 
in = frame.getClass() .getResourceAsStream(language + ".properties"); 
events. ]load(in); 


for (final Object e : events. keySet()) 
{ 


String[] s = ((String) e).split("\\."); 
addListener(s[0], s[1], (String) events.get(e), engine, components) ; 
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} 
frame, setTitle("ScriptTest"); 
frame, setDefaultCloseOperation(JFrame. EXIT_ON_CLOSE); 
frame, setVisible(true); 
} 
catch (ReflectiveOperationException | IOException 
| ScriptException | IntrospectionException ex) 


ex.printStackTrace() ; 


Di 
} 


kk 


* Gathers all named components in a container. 
* @param c the component 
* @param namedComponents a map into which to enter the component names and components 
*/ 
private static void getComponentBindings (Component c, Map<String, Component> namedComponents) 
{ 
String name = c.getName() ; 
if (name != null) { namedComponents.put(name, c); } 
if (c instanceof Container) 


for (Component child : ((Container) c).getComponents ()) 
getComponentBindings(child, namedComponents) ; 


} 
/** 


* Adds a listener to an object whose listener method executes a script. 
* @param beanName the name of the bean to which the listener should be added 
* @param eventName the name of the listener type, such as "action" or "change" 
* @aram scriptCode the script code to be executed 
* @aram engine the engine that executes the code 
* @param bindings the bindings for the execution 
* @throws IntrospectionException 
* 
/ 
private static void addListener(String beanName, String eventName, final String scriptCode, 
final ScriptEngine engine, Map<String, Component> components) 
throws ReflectiveOperationException, IntrospectionException 


Object bean = components. get (beanName) ; 
EventSetDescriptor descriptor = getEventSetDescriptor(bean, eventName) ; 
if (descriptor == null) return; 
descriptor. getAddListenerMethod() .invoke(bean, 
Proxy.newProxyInstance(null, new Class[] { descriptor.getListenerType() }, 
(proxy, method, args) -> 
{ 


engine.eval (scriptCode) ; 
return null; 


J) 
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113 private static EventSetDescriptor getEventSetDescriptor(Object bean, String eventName) 


114 throws IntrospectionException 

115 f{ 

116 for (EventSetDescriptor descriptor : Introspector.getBeanInfo(bean.getClass()) 
117 .getEventSetDescriptors()) 

118 if (descriptor.getName() .equals(eventName)) return descriptor; 

119 return null; 





1 package buttons1; 
2 
3 import javax.swing.*; 


4 

5 /** 

6 * A frame with a button panel. 

7 * @version 1.00 2007-11-02 

8 * @author Cay Horstmann 

g */ 

10 public class ButtonFrame extends JFrame 

u { 

12 private static final int DEFAULT_WIDTH = 300; 
13 private static final int DEFAULT_HEIGHT = 200; 


15 private JPanel panel; 

16 private JButton yellowButton; 
17 private JButton blueButton; 
18 private JButton redButton; 

20 public ButtonFrame() 


{ 
22 SetSize(DEFAULT_WIDTH, DEFAULT_HEIGHT) ; 


24 panel = new JPanel (); 

25 panel .setName("panel"): 

26 add (panel); 

27 

28 yellowButton = new JButton("Yellow"); 
29 yel lowButton. setName ("yellowButton") ; 
30 blueButton = new JButton("Blue"); 

31 blueButton.setName("blueButton") ; 

32 redButton = new JButton("Red"); 

33 redButton. setName("redButton") ; 

34 

35 panel .add(yel lowButton) ; 

36 panel .add(blueButton) ; 

37 pane] .add(redButton) ; 

38 } 
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8.2 ”编译 器 API 


在 前 面 的 小 节 中 ， 你 看 到 了 如 何 与 用 脚本 语言 编写 的 代码 进行 交互 。 现 在 我 们 转 加 不 同 
的 场景 : 编译 Java 代码 的 Java 程序 。 有 许多 工具 都 需要 调用 Java jakar, PAN: 

e 开发 环境 。 

o Java 教学 和 辅导 程序 。 

e 自动 化 的 构建 和 测试 工具 。 

e 处 理 Java 代码 段 的 模板 工具 ， 例 如 JavaServer Pages (JSP). 

在 过 去 ， 应 用 程序 是 通过 在 jdk/1ib/tools. jar 类 库 中 未 归档 的 类 调用 Java Ba PE at 
的 。 如 今 一 个 用 于 编译 的 公共 API 成 为 Java 平台 的 一 部 分 ， 并 且 它 再 也 不 需要 使 用 too1s . 
jar 了 ， 这 就 是 本 节 将 要 解释 的 编 详 项 API. 


8.2.1 编译 便捷 之 法 
调用 编译 器 非常 简单 ， 下 面 是 一 个 示范 调用 : 


JavaCompiler compiler = Tool Provider.getSystemJavaCompi ler () ; 

OutputStream outStream=.. .; 

OutputStream errStream =. . .; 

int result = compiler.run(null, outStream, errStream, "-sourcepath", "src", "Test. java"); 


返回 值 为 0 表示 编译 成 功 。 

编译 器 会 向 提供 给 它 的 流 发 送 输出 和 错误 消息 。 如 果 将 这 些 参数 设置 为 nu11， 就 会 使 
用 System.out 和 System.err。run 方法 的 第 一 个 参数 是 输入 流 ， 由 于 编译 器 不 会 接受 任 
何 控制 台 输 入 ， 因 此 总 是 应 该 让 其 保持 为 nu11。( run 方法 是 从 泛 化 的 Tool 接口 继承 而 来 
的 ， 它 考虑 到 某 些 工具 需要 读 取 输 入 。) 

如 果 在 命令 行 调用 javac, WA run 方法 其 余 的 参数 就 会 作为 变量 传递 给 javac。 这 些 
变量 是 一 些 选 项 或 文件 名 。 


8.2.2 ”使 用 编译 工具 


可 以 通过 使 用 Compi lationTask 对 象 来 对 编译 过 程 进 行 更 多 的 控制 。 特 别 是 ， 你 可 以 : 

e 控制 程序 代码 的 来 源 ， 例 如 ， 在 字符 串 构建 器 而 不 是 文件 中 提供 代码 。 

e 控制 类 文件 的 放置 位 置 ， 例 如 ， 存 储 在 数据 库 中 。 

e 监听 在 编译 过 程 中 产生 的 错误 和 和 警告 信息 。 

e (En BIS TT aa o 

源 代 码 和 类 文件 的 位 置 是 由 JavaFileManager 控制 的 ， 它 负责 确定 源 代 码 和 类 文件 的 
JavaFileObject 实例 。JavaFile0bject 可 以 对 应 于 磁盘 文件 ， 或 者 可 以 提供 读 写 其 内 容 
的 其 他 机 制 。 

为 了 监听 错误 消息 ， 需 要 安装 一 个 DiagnosticListener。 这 个 监听 器 在 编译 需 报 告警 
告 或 错误 消息 时 会 收 到 一 个 Di agnostic xfA, DiagnosticCollector 类 实现 了 这 个 接口 ， 
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它 将 收集 所 有 的 诊断 信息 ， 使 得 你 可 以 在 编译 完成 之 后 遍历 这 些 信息 。 
Diagnostic 对 象 包 含有 关 问 题 位 置 的 信息 (包括 文件 名 、 行 号 和 列 号 ) 以 及 人 类 可 阅 
读 的 描述 。 
可 以 通过 调用 JavaCompiler 类 的 getTask 方法 来 获得 CompilationTask 对 象 。 这 
时 需要 指定 : 
e 一 个 用 于 所 有 编译 需 输 出 的 writer， 它 不 会 将 输出 作为 Diagnostic 报告 。 如 果 是 
nul11， 则 使 用 System.err。 
e 一 个 uavaFileManager， 如 果 为 nu11， 则 使 用 编译 器 的 标准 文件 管理 器 。 
e 一 个 DiagnosticListener。 
e 选项 字符 串 ， 如 果 没 有 选项 ， 则 为 nu11。 
o 用 于 注解 处 理 的 类 名 字 ， 如 果 没 有 指定 类 名 字 ， 则 为 nu11。( 我 们 将 在 本 章 后 面 的 内 
容 中 讨论 注解 处 理 。) 
e 用 于 源 文 件 的 JavaFi1e0bject 实例 。 
需要 为 最 后 三 个 参数 提供 Iterable 对 象 。 例 如 ， 选 项 序列 可 以 指定 为 : 


Iterable<String> options = Arrays.asList("-g", "-d", "classes"); 


或 者 ， 可 以 使 用 任何 集合 类 。 
如 有 果 布 望 编译 器 从 磁盘 读 取 源 文件 ， 那 么 可 以 让 StandardJavaFileManager 将 文件 
名 字符 串 或 File 对 象 转译 成 JavaObject 实例 。 例 如 ， 


StandardJavaFi leManager fileManager = compiler.getStandardFileManager(null, null, null): 
Iterable<JavaFileObject> fileObjects = fileManager.getJavaFileObjectsFromStrings (fil eNames) ; 


但 是 ， 如 果 和 希望 编译 器 从 磁盘 文件 之 外 的 其 他 地 方 读 取 源 代码 ， 那 么 可 以 提供 自己 的 Java 
FileObject 的 子 类 。 程 序 清单 8-3 展示 了 一 种 源 文件 对 象 的 代码 ， 这 种 对 象 的 数据 包含 在 一 
个 StringBuilder 中 。 这 个 类 扩展 自 SimpledJavaFileObject 便利 类 ， 并 覆盖 了 getChar 
Content 方法 ， 让 其 返回 字符 串 构 建 器 中 的 内 容 。 我 们 在 示例 程序 中 使 用 这 个 类 来 动态 产生 
一 个 Java 类 的 代码 ， 然 后 编译 了 这 些 代码 。 

CompilationTask 接口 扩展 了 Callable<Boolean> 接口 ， 可 以 将 其 传递 给 一 个 Executor, 
使 其 可 以 在 男 一 个 线程 中 执行 ， 或 者 可 以 直接 调用 cal] 方法 。 返 回 值 如 果 是 Boolean .FALSE， 
则 表示 调用 失败 。 


Callable<Boolean> task = new JavaCompiler.CompilationTask(null, fileManager, diagnostics, 
options, null, fileObjects) ; 
if (!task.callQ) 
System.out.print]n("Compilation failed"): 


如 果 只 是 想 让 编译 器 在 磁盘 上 生成 类 文件 ， 则 不 需要 定制 JavaFileManager, (Hi, 
我 们 的 示例 应 用 是 将 类 文件 生成 在 字 节 数组 中 ， 稍 后 会 使 用 特殊 的 类 加 载 器 将 其 从 内 存 中 读 
出 。 程 序 清 单 8-4 定义 了 一 个 实现 了 JavaFile0bject 接口 的 类 ， 其 open0utputStream 
方法 将 返回 编译 器 将 要 在 其 中 放置 字 节 码 的 ByteArrayOutputStream, 

事实 证 明 ， 要 告知 编译 吉 的 文件 管理 器 去 使 用 这 些 文件 对 象 还 是 比较 环 手 的 ， 因 为 
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类 库 没 有 提供 实现 了 StandardJavaFileManager 接口 的 类 。 因 此 ， 我 们 需要 子 类 化 
ForwardingJavaFileManager 类 ， 该 类 将 所 有 的 调用 都 代理 给 了 给 定 的 文件 管理 器 。 在 我 
们 所 处 的 情况 中 ， 我 们 只 想 修 改 getJavaFileFor0utput 方法 ,我 们 通过 下 面 的 代码 框 染 
达到 了 这 个 目的 : 

JavaFileManager fileManager = compiler.getStandardFileManager(diagnostics, null, null); 


fileManager = new ForwardingJavaFileManager<JavaFi leManager>(fi | eManager) 


public JavaFileObject getJavaFileForOutput (Location location, final String className, 
= Kind kind, FileObject sibling) throws IOException 
{ 


} 
Hi 


总 之 ， 如 果 只 是 想 以 常规 的 方式 调用 编译 器 ， 那 就 只 需要 调用 JavaCompi ler 任务 的 
run 方法 ， 去 读 写 磁盘 文件 。 你 可 以 捕获 输出 和 错误 消息 ， 但 是 需要 你 自己 去 解析 它们 。 

如 果 想 对 文件 处 理 和 错误 报告 进行 更 多 的 控制 ， 可 以 使 用 CompilationTask 类 。 它 的 
API 非常 复杂 ,但 是 可 以 控制 编译 过 程 的 每 个 方面 。 


return custom file object 








1 package compiler; 
2 
3 Import java.net.*; 
4 import javax.tools.*; 
5 
6 /* 
7 * A Java source that holds the code in a string builder. 
8 * @version 1.00 2007-11-02 
9 * @author Cay Horstmann 


10 */ 

ıı public class StringBuilderJavaSource extends SimpleJavaFile0bject 

n { 

13 private StringBuilder code; 

14 

15 /** 

16 * Constructs a new StringBuilderJavaSource. 

17 * @param name the name of the source file represented by this file object 
18 * | 


19 public StringBuilderJavaSource(String name) 


21 super(URI.create("string:///" + name.replace('.', '/') + Kind.SOURCE.extension), 
22 Kind. SOURCE) ; 

23 code = new StringBuilder(); 

24 } 


25 public CharSequence getCharContent (boolean ignoreEncodingErrors) 


28 return code; 


29 } 
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31 public void append(String str) 
{ 


33 code. append(str) ; 
34 code. append('\n'); 
35 } 

36 } 






1 package compiler; 

2 

3 Import java.io.*; 

4 import java.net.*; 

5 import javax.tools.*; 
6 


7 /** 

8 * A Java class that holds the bytecodes in a byte array. 
9 * @ersion 1.00 2007-11-02 

10 * @author Cay Horstmann 


nu */ 

12 public class ByteArrayJavaClass extends SimpleJavaFileQbject 

3 { 

14 private ByteArrayOutputStream stream: 

15 

16 /** 

17 * Constructs a new ByteArrayJavaClass. 

18 * @aram name the name of the class file represented by this file object 
19 */ 


20 public ByteArrayJavaClass (String name) 


22 super(URI.create("bytes:///" + name), Kind. CLASS); 
23 Stream = new ByteArrayOutputStream() ; 


26 public OutputStream openOutputStream() throws IOException 


27 { 
28 return stream: 
29 } 


31 public byte[] getBytes() 
{ 


33 return stream. toByteArray() ; 








e int run(InputStream in, OutputStream out, OutputStream err, 
String... arguments ) 


用 给 定 的 输入 、 输 出 、 错 误 流 ， 以 及 给 定 的 参数 来 运行 该 工具 。 返 回 值 为 0 表示 成 功 ， 
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JE 0 值 表示 失败 。 





e StandardJavaFileManager getStandardFileManager(DiagnosticListener<? super 
JavaFileObject> diagnosticListener, Locale locale, Charset charset) 
获取 该 编译 器 的 标准 文件 管理 器 。 如 果 要 使 用 默认 的 错误 报告 机 制 、locale 和 字符 集 等 
参数 ， 则 可 以 提供 null。 

e Javacompiler.CompilationTaskgetTask(Writerout，JUavaFileManagerfi1eManager， 
DiagnosticListener<? super JavaFileObject> diagnosticListener, 
Iterable<String> options, Iterable<String> classesForAnnotationProcessing, 
Iterable<? extends JavaFileObject> sourceFiles) 
获取 编译 任务 ， 在 被 调用 时 ， 该 任务 将 编译 给 定 的 源 文 件 。 参 见 前 一 节 中 有 关 这 部 分 
内 容 的 详细 讨论 。 





e Iterable<? extends JavaFileObject> getJavaFileObjectsFromStrings(I 
terable<String> fileNames ) 

e Iterable<? extends JavaFileObject> getJavaFileObjectsFromFiles(Ite 
rable<? extends File> files) 


将 文件 名 或 文件 序列 转译 成 一 个 JavaFi1e0bject 实例 序列 。 


GF 





e Boolean call() 


执行 编译 任务 。 





e DiagnosticCollector() 
Fat — 28 WR A o 
e List<Diagnostic<? extends S>> getDiagnostics() 


获取 收集 到 的 诊断 信息 。 





eS getSource() 
获取 与 该 诊断 信息 相关 联 的 源 对 象 。 
e Diagnostic.Kind getKind() 
获取 该 诊断 信息 的 类 型 ， 返 回 值 为 ERROR，WARNING，MANDATORY_WARNING NOTE 


或 OTHER 之 一 。 
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eString getMessage(Locale locale) 


获取 一 条 消息 ， 这 条 消息 描述 了 由 该 诊断 信息 所 揭示 的 问题 。 如 果 要 使 用 默认 的 
Locale， 则 传递 null。 

è long getLineNumber() 

e long getColumnNumber( ) 


获取 由 该 诊断 信息 所 揭示 的 问题 的 位 置 。 





e CharSequence getCharContent(boolean ignoreEncodingErrors) 
对 于 表示 源 文件 并 产生 源 代 码 的 文件 对 象 ， 需 要 覆盖 该 方法 。 

e OutputStream openOutputStream( ) 
对 于 表示 类 文件 并 产生 字 节 码 可 写 和 人 其 中 的 流 的 文件 对 象 ， 需 要 覆盖 该 方法 。 





e protected ForwardingJavaFileManager(M fileManager ) 
构造 一 个 JavaFileManager， 它 将 所 有 的 调用 都 代理 给 指定 的 文件 管理 器 。 
eFileObjectgetFileForOutput(JavaFileManager.Locationlocation, 
StringclassName, JavaFileObject. Kind kind, FileObject sibling) 
如 果 和 希望 替换 用 于 写 出 类 文件 的 文件 对 象 ， 则 需要 拦截 该 调用 。kind 的 值 是 SOURCE ， 
CLASS, HTML 或 OTHER 之 一 。 


8.2.3 一 个 示例 : 动态 Java 代码 生成 
在 用 于 动态 Web 页 面 的 ISP 技术 中 ， 可 以 在 HTML 中 混杂 Java 代码 ， 例 如 ， 


<p>The current date and time is <b><%= new java.util.Date() %></b>.</p> 


JSP 引擎 动态 地 将 Java 代码 编译 到 Servlet 中 。 在 示例 应 用 中 ， 我 们 使 用 了 一 个 更 简 
单 的 示例 ， 它 可 以 动态 生成 Swing 代码 。 其 基本 思想 是 使 用 GUI 构建 器 在 窗 体 中 放置 构 
件 ， 并 在 一 个 外 部 文件 中 指定 构件 的 行为 。 程 序 清单 8-5 展示 了 一 个 非常 简单 的 窗 体 类 实 
例 ， 而 程序 清单 8-6 展示 了 按钮 动作 的 代码 。 请 注意 ， 窗 体 类 的 构造 器 调用 了 抽象 方法 
addEventHandlers。 我 们 的 代码 生成 器 将 产生 一 个 实现 了 addEventHandlers 方法 的 子 
X, HX} action .properties 类 的 每 一 行 都 添加 了 动作 监听 器 。( 我 们 给 读者 留 下 了 一 个 
典型 的 练习 ， 即 扩展 代码 的 生成 功能 ， 使 其 支持 其 他 的 事件 类 型 。) 

我 们 将 这 个 子 类 置 于 名 字 为 x 的 包 中 ， 因 为 我 们 不 希望 在 程序 的 其 他 地 方 用 到 它 。 所 生 
成 的 代码 有 如 下 形式 : 


package x: 
public class Frame extends SuperclassName 


{ 
protected void addEventHandlers() 
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{ 


componentName, .addActionListener(new java.awt.event. ActionListener () 


public void actionPerformed(java.awt.event.ActionEvent) { code for event handler, } 


// ou for the other event handlers ... 

} 

程序 清单 8-7 的 程序 中 的 buildSource 方 法 构建 了 这 些 代 码 ， 并 将 它们 放 到 了 
StringBuilderJavaSource 对 象 中 。 该 对 象 会 传递 给 Java Barat. 

我 们 使 用 了 一 个 ForwardingJavaFileManager 对 象 ， 它 具有 getJavaFileForOutput 
方法 ， 该 方法 将 为 x 包 中 的 每 个 类 构造 一 个 ByteArrayJavaClass 对 象 ， 而 这 些 对 和 象 会 捕 
获 x. Frame 类 被 编译 时 所 生成 的 类 文件 。 该 方法 将 每 个 文件 对 象 都 添加 到 了 一 个 列表 中 ， 
然后 将 其 返回 ， 以 使 得 我 们 稍 后 可 以 定位 这 些 字 节 码 。 请 注意 ， 编 译 x.Frame 类 会 为 主 类 
生成 一 个 类 文件 ， 并 为 每 个 监听 器 类 生成 一 个 类 文件 。 

在 编译 之 后 ， 我 们 构建 了 一 个 映射 表 ， 它 将 类 名 与 字 节 码 数组 关联 在 一 起 。( 程 序 清单 8-8 
所 示 的 ) 一 个 简单 的 类 加 载 器 可 以 用 来 加 载 在 这 个 映射 表 中 存储 的 类 。 

我 们 让 类 加 载 器 去 加 载 刚刚 编译 过 的 类 ， 然 后 构建 并 显示 该 应 用 的 窗 体 类 。 


ClassLoader loader = new MapClassLoader(byteCodeMap) ; 
Class<?> cl = loader. loadClass("x.Frame") ; 

Frame frame = (JFrame) cl.newInstance(); 

frame. setVisible(true) ; 


当 点 击 按钮 时 ， 背 景色 会 按照 常规 方式 进行 修改 。 为 了 查看 这 些 动作 是 动态 编译 的 ， 需 
要 更 改 action.properties 文件 中 一 行 ， 例 如 ， 修 改 成 下 面 这 样 : 

yel lowButton=panel .setBackground (java, awt.Color.YELLOW); yellowButton, setEnabled(false); 

再 次 运行 这 个 程序 ， 现 在 ， 黄 色 按钮 在 点 击 之 后 就 变 得 禁用 了 。 再 看 看 代码 目录 ， 你 不 
会 发 现 x 包 中 的 类 的 任何 源 文件 和 类 文件 。 这 个 示例 向 你 演示 了 如 何 通过 内 存 中 的 源 文件 和 
类 文件 来 使 用 动态 编译 。 


igi 
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1 package buttons2; 

2 Import javax.swing.*; 

3 

4 [** 

5 * A frame with a button panel. 

6 * @version 1.00 2007-11-02 

7 * @author Cay Horstmann 

ae: 

3 public abstract class ButtonFrame extends JFrame 
10 { 

11 public static final int DEFAULT_WIDTH = 300; 
12 public static final int DEFAULT_HEIGHT = 200; 
13 

14 protected JPanel panel; 
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yel lowButton=panel . setBackground(java.awt .Color. YELLOW) ; 
blueButton=panel . setBackground(java.awt.Color. BLUE) ; 
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protected JButton yellowButton; 
protected JButton blueButton; 
protected JButton redButton; 


protected abstract void addEventHandlers() ; 


public ButtonFrame() 


{ 
setSize(DEFAULT_WIDTH, DEFAULT_HEIGHT) ; 


panel = new JPanel(); 
add (panel); 


yel antton = new JButton("Yellow"); 
lueButton = new JButton("Blue"); 


redButton = new JButton("Red"); 


panel .add(yel lowButton) ; 
panel .add(blueButton) ; 
panel] .add(redButton) ; 


addEventHandlers(); 








package compiler; 


import java.awt.*; 

import java.i0.*; 

import java.util.*; 

import java.util.List; 

import javax.swing.*; 

import javax.tools.*: 

import javax.tools.JavaFileObject.*; 


/* 
* @ersion 1.01 2016-05-10 
* @author Cay Horstmann 
*} 
public class CompilerTest 
public static void main(final String[] args) throws IOException, ClassNotFoundException 


{ 


JavaCompiler compiler = Tool Provider. getSystemJavaCompi ler() ; 


final List<ByteArrayJavaClass> classFileObjects = new ArrayList<>(Q); 
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DiagnosticCollector<JavaFileObject> diagnostics = new DiagnosticCollector<>(); 


JavaFileManager fileManager = compiler.getStandardFileManager(diagnostics, null, null); 
fileManager = new ForwardingJavaFileManager<JavaFi | eManager>(fi | eManager) 


public JavaFileObject getJavaFileForOutput (Location location, final String className, 
Kind kind, FileObject sibling) throws IOException 


if (className.startsWith("x.")) 

{ 
ByteArrayJavaClass fileObject = new ByteArrayJavaClass(className) ; 
classFileObjects.add(fileQbject) ; 
return fileObject; 

} 

else return super.getJavaFileForOutput(location, className, kind, sibling); 

} 
}; 


String frameClassName = args.length == 0 ? "buttons2.ButtonFrame" : args[0] ; 

JavaFileObject source = buildSource(frameCl assName) ; 

JavaCompiler.CompilationTask task = compiler.getTask(null, fileManager, diagnostics, null, 
null, Arrays.asList(source)) ; 

Boolean result = task.call(); 


for (Diagnostic<? extends JavaFileQbject> d : diagnostics. getDiagnostics()) 
System.out.printIn(d.getKind() + ": " + d.getMessage(null)); 

fi leManager.close(); 

if (!result) 

{ 
System.out.printIn("Compilation failed."); 
System. exit(1); 


} 


EventQueue.invokeLater(() -> 
{ 

try 

{ 
Map<String, byte[]> byteCodeMap = new HashMap<>() ; 
for (ByteArrayJavaClass cl : classFileObjects) 

byteCodeMap.put(cl.getName() .substring(1), cl.getBytes()); 

ClassLoader loader = new MapClassLoader(byteCodeMap) ; 
JFrame frame = (JFrame) loader. ]oadClass("x.Frame") .newLnstance(); 
frame. setDefaul tCloseOperation(JFrame.EXIT_ON_CLOSE) ; 
frame.setTitle("CompilerTest") ; 
frame. setVisible(true) ; 


catch (Exception ex) 
{ 


ex.printStackTrace() ; 


Hi 


/* 
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77 * Builds the source for the subclass that implements the addEventHandlers method. 
78 * @return a file object containing the source in a string builder 

79 */ 

80 static JavaFileObject buildSource(String superclassName) 

81 throws IOException, ClassNotFoundException 

82 { 

83 StringBuilderJavaSource source = new StringBuilderJavaSource("x.Frame") ; 
84 source.append("package x;\n"); 

85 source.append("public class Frame extends ”+ superclassName + " {"); 

86 source.append ("protected void addEventHandlers() {"); 

87 final Properties props = new Properties(); 

88 props. load(Class. forName(superclassName) .getResourceAsStream("action.properties")); 
89 for (Map.Entry<Object, Object> e : props.entrySet()) 

90 

91 String beanName = (String) e.getKey(); 

92 String eventCode = (String) e.getValue(); 

93 source.append(beanName + ".addActionListener(event -> {"); 

94 source. append(eventCode) ; 

95 source.append("} );"); 

96 } 

97 source.append("} }"); 

98 return source; 

99 } 

100 } 





package compiler; 


import java.util.*; 


* A class loader that loads classes from a map whose keys are class names and whose values are 
* byte code arrays. 

* @ersion 1.00 2007-11-02 

* @author Cay Horstmann 

10 */ 

11 public class MapClassLoader extends ClassLoader 

ù { 


13 private Map<String, byte[]> classes; 


1 
2 
3 
4 
5 /** 
6 
7 
8 
9 


15 public MapClassLoader(Map<String, byte[]> classes) 


16 { 

17 this.classes = classes; 

18 } 

19 

20 protected Class<?> findClass(String name) throws ClassNotFoundException 
21 { 

22 byte[] classBytes = classes.get(name) ; 

23 if (classBytes == null) throw new ClassNotFoundException(name) ; 

24 Class<?> cl = defineClass(name, classBytes, 0, classBytes. length); 
25 if (cl == null) throw new ClassNotFoundException(name) ; 

26 return cl; 
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27 } 
28 + 


8.3 ”使 用 注解 


注解 是 那些 插入 到 源 代码 中 使 用 其 他 工具 可 以 对 其 进行 处 理 的 标签 。 这 些 工具 可 以 在 源 
码 层 次 上 进行 操作 ， 或 者 可 以 处 理 编译 器 在 其 中 放置 了 注解 的 类 文件 。 

注解 不 会 改变 程序 的 编译 方式 。Java 编译 器 对 于 包含 注解 和 不 包含 注解 的 代码 会 生成 相 
同 的 虚拟 机 指令 。 

为 了 能 够 受益 于 注解 ， 你 需要 选择 一 个 处 理工 具 ， 然 后 向 你 的 处 理工 具 可 以 理解 的 代码 
中 插入 注解 ， 之 后 运用 该 处 理工 具 处 理 代码 。 

注解 的 使 用 范围 还 是 很 广泛 的 ， 并 且 这 种 广泛 性 让 人 告 一 看 会 觉得 有 些 杂 乱 无 草 。 下 面 
是 关于 注解 的 一 些 可 能 的 用 法 : 

e 附属 文件 的 自动 生成 ， 例 如 部 署 描述 符 或 者 bean 信息 类 。 

e 测试 、 日 志 、 事 务 语义 等 代码 的 目 动 生成 。 


8.3.1 注解 简介 


我 们 首先 介绍 基本 概念 ， 然 后 将 这 些 概念 运用 到 一 个 具体 示例 中 : 我 们 将 某 些 方法 标注 
为 AWT 构件 的 事件 监听 器 ， 然 后 向 你 展示 一 个 能 够 分 析 注 解 和 连接 监听 天 的 注解 处 理 天 。 
然后 ， 我 们 对 其 语法 规则 进行 详细 讨论 。 最 后 我 们 以 两 个 注解 处 理 的 高 级 示例 结束 本 革 。 其 
中 一 个 可 以 处 理 源 代码 级 别 的 注解 。 另 外 一 个 使 用 了 Apache WF WHS TRAE, BY LATHE 
解 过 的 方法 中 添加 额外 的 字 节 码 。 

下 面 是 一 个 简单 注解 的 示例 : 

class MyClass 


@Test public void checkRandomInserti ons () 


注解 @Test 用 于 注解 checkRandomInsertions 方法 。 

在 Java 中 ， 注 解 是 当 作 一 个 修饰 符 来 使 用 的 ， 它 被 置 于 被 注解 项 之 前 ， 中 间 没 有 分 号 。( 修 饰 
符 就 是 诸如 public 和 static 之 类 的 关键 词 。) 每 一 个 注解 的 名 称 前面 都 加 上 了 @ 符 号 ， MAR 
类 似 于 Javadoc 的 注释 。 然 而 ，Javadoc 注释 出 现在 /**...*/ 定 界 符 的 内 部 ， 而 注解 是 代码 的 一 部 分 。 

eTest 注解 自身 并 不 会 做 任何 事情 ， 它 需要 工具 支持 才 会 有 用 。 例 如 ， 当 测试 一 个 类 的 
时 候 ，JUnit4 测试 工具 (可 以 从 http://junit .org 处 获得 ) 可 能 会 调用 所 有 标识 为 eTest 
的 方法 。 另 一 个 工具 可 能 会 删除 一 个 类 文件 中 的 所 有 测试 方法 ， 以 便 在 对 这 个 类 测试 完毕 
后 ， 不 会 将 这 些 测试 方法 与 程序 装载 在 一 起 。 

注解 可 以 定义 成 包含 元 素 的 形式 ， 例 如 : 
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Test (timeout="10000") 

这 些 元 素 可 以 被 谈 取 这 些 注解 的 工具 去 处 理 。 其 他 形式 的 元 素 也 是 有 可 能 的 ; 我 们 将 会 
在 本 章 的 随后 部 分 进行 讨论 。 

除了 方法 外 ， 还 可 以 注解 类 、 成 员 以 及 局 部 变量 ， 这 些 注 解 可 以 存在 于 任何 可 以 放置 一 
MR public 或 者 static 这 样 的 修饰 符 的 地 方 。 男 外 ， 正 如 在 8.4 节 中 看 到 的 ， 你 还 可 以 
注解 包 、 参 数 变量 、 类 型 参数 和 类 型 用 法 。 

每 个 注解 都 必须 通过 一 个 注解 接口 进行 定义 。 这 些 接口 中 的 方法 与 注解 中 的 元 素 相 对 

。 例 如 ，JUnit 的 注解 Test 可 以 用 下 面 这 个 接口 进行 定义 : 


@Target(ElementType.METHOD) 
@Retention(RetentionPolicy. RUNTIME) 
public @interface Test 


long timeout() default OL; 


} 

@interface 声明 创建 了 一 个 真正 的 Java 接口 。 处 理 注解 的 工具 将 接收 那些 实现 了 这 个 注 
解 接口 的 对 象 。 这 类 工具 可 以 调用 timeout 方法 来 检索 某 个 特定 Test 注解 的 timeout 元 素 。 

注解 Target 和 Retention 是 元 注解 。 它 们 注解 了 Test 注解 ， 即 将 Test 注解 标识 成 
一 个 只 能 运用 到 方法 上 的 注解 ， 并 且 当 类 文件 载 人 到 虚拟 机 的 时 候 ， 仍 可 以 保留 下 来 。 我 们 
将 会 在 8.5.3 详细 讨论 这 些 元 注解 。 

你 现在 已 经 清楚 了 程序 的 元 数据 和 注解 这 两 个 概念 。 在 接 下 来 的 小 节 中 ， 我 们 将 深入 到 
一 个 注解 处 理 的 具体 示例 中 继续 探讨 。 


8.3.2 一 个 示例 : 注解 事件 处 理 器 


在 用 户 界面 编程 中 ， 一 件 更 令 人 讨厌 的 事情 就 是 组 装 事 件 源 上 的 监听 需 。 很 多 监听 融 是 
下 面 这 种 形式 的 : 

myButton.addActionListener(() -> doSomething()) ; 

ERT, 我们 设计 了 一 个 注解 来 免除 这 种 亩 差事 。 该 注解 是 在 程序 清单 8-11 中 定义 的 ， 


@ActionListenerFor(source="myButton") void doSomething() {... } 

程序 员 不 再 需要 去 调用 addActionListener 了 。 相 反 地 ， 每 个 方法 直接 用 一 个 注解 标 
记 起 来 。 程 序 清 单 8-10 展示 了 卷 1 第 11 章 的 ButtonFrame 程序 ， 但 是 使 用 上 述 这 类 注解 
重新 实现 了 一 过 。 

我 们 还 需要 定义 一 个 注解 接口 ， 代 码 在 程序 清单 8-11 中 。 





EEE ESS Sy pe epee ae 


1 package runtimeAnnotations; 
2 
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3 import java.awt.event.*; 
4 import java.lang.reflect.*; 


6 /** 

7 * @version 1.00 2004-08-17 

8 * @author Cay Horstmann 

9 */ 

10 public class ActionListenerInstal ler 

u {í 

12 /** 

13 * Processes all ActionListenerFor annotations in the given object. 

14 * @param obj an object whose methods may have ActionListenerFor annotations 
15 */ 

16 public static void processAnnotations (Object obj) 

17 { 

18 try 

19 { 

20 Class<?> cl = obj.getClass(Q); 

21 for (Method m : cl.getDeclaredMethods ()) 

22 { 

23 ActionListenerFor a = m.getAnnotation(ActionListenerFor.class) ; 
24 if (a != null) 

25 { 

26 Field f = cl.getDeclaredField(a.source()) ; 

27 f.setAccessible(true) ; 

28 addListener(f.get(obj), obj, m); 

29 } 

30 } 

31 } 

32 catch (ReflectiveOperationException e) 

33 

34 e.printStackTrace() ; 

35 } 

36 } 

37 

33 /** 

39 * Adds an action listener that calls a given method. 

40 * @aram source the event source to which an action listener is added 
41 * @param param the implicit parameter of the method that the listener calls 
42 * @param m the method that the listener calls 

43 */ 

4 public static void addListener(Object source, final Object param, final Method m) 
45 throws ReflectiveOperationException 

46 { 

47 InvocationHandler handler = new InvocationHandler() 

48 { 

49 public Object invoke(Object proxy, Method mm, Object[] args) throws Throwable 
50 { 

51 return m.invoke(param) ; 

52 } 

53 J; 

54 

55 Object listener = Proxy.newProxyInstance(nul] , 

56 new Class[] { java.awt.event.ActionListener.class }, handler); 


i 
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Method adder = source.getClass().getMethod("addActionListener", ActionListener.class); 
adder.invoke(source, listener); 





package buttons3; 


import java.awt.*; 
import javax.swing.*; 
import runtimeAnnotations. *; 


/** 
* A frame with a button panel. 
* @version 1.00 2004-08-17 
* @author Cay Horstmann 
| 
public class ButtonFrame extends JFrame 
{ 
private static final int DEFAULT_WIDTH = 300; 
private static final int DEFAULT_HEIGHT = 200; 


private JPanel panel; 

private JButton yellowButton; 
private JButton blueButton; 
private JButton redButton; 


public ButtonFrame() 
setSize(DEFAULT_WIDTH, DEFAULT HEIGHT) ; 


panel = new JPanel (); 
add (panel); 


yellowButton = new JButton("Yel low"); 
blueButton = new JButton("Blue");: 
redButton = new JButton("Red"); 


panel .add(yel lowButton) ; 
panel .add(blueButton) ; 
panel .add(redButton) ; 


ActionListenerInstaller.processAnnotations(this) ; 


} 


@ActionListenerFor(source = "yellowButton") 
public void yellowBackground() 


{ 
panel .setBackground(Color. YELLOW) ; 


} 


@ActionListenerFor(source = "blueButton") 
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47 public void blueBackground() 


so | 
49 panel .setBackground (Color. BLUE) ; 
;0 } 


52 @ActionListenerFor(source = "redButton") 
;3 public void redBackground() 


55 panel. setBackground (Color . RED) ; 






pi Oe aye, Sane hgh 
4% oe ee 村 
FURR SS fe lS eee ie fort aie 


package runtimeAnnotations; 


import java. lang.annotation.*; 


* @version 1.00 2004-08-17 
* @author Cay Horstmann 


gi 


10 @Target (El ementType. METHOD) 

11 @Retention(Retenti onPolicy. RUNTIME) 
12 public Ginterface ActionListenerFor 
13 { 


14 String source(); 


1 
2 
3 
4 
5 /** 
6 
7 
8 
9 





当然 ， 这 些 注解 本 身 不 会 做 任何 事情 ， 它 们 只 是 存在 于 源 文 件 中 。 编 译 器 将 它们 置 于 类 
文件 中 ， 并 且 虚 拟 机 会 将 它们 载 和 人 。 我 们 现在 需要 的 是 一 个 分 析 注 解 以 及 安装 行为 监听 右 的 
机 制 。 这 也 是 类 ActionListenerInstaller 的 职责 所 在 。ButtonFrame 构造 右 将 调用 下 
面 的 方法 : 

ActionListenerInstaller.processAnnotations (this) ; 

静态 的 processAnnotations 方法 可 以 枚 举 出 某 个 对 象 接收 到 的 所 有 方法 。 对 于 每 一 
个 方法 ， 它 先 获取 ActionListenerFor 注解 对 象 ， 然 后 再 对 它 进行 处 理 。 


Class<?> cl = obj.getClass(); 
for (Method m : cl.getDeclaredMethods()) 


{ 


ActionListenerFor a = m.getAnnotation(ActionListenerFor.class) ; 
if (a l= mil) ssa 
} 


这 里 ， 我 们 使 用 了 定义 在 AnnotatedElement 接 口中 的 getAnnotation 方 法 。 
Method. Constructor, Field, Class fil Package 这 些 类 都 实现 了 这 个 接口 。 
源 成 员 域 的 名 字 是 存储 在 注解 对 象 中 的 。 我 们 可 以 通过 调用 source 方法 对 它 进行 检索 ， 
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然后 查找 匹配 的 成 员 域 。 


String fieldName = a.source(); 
Field f = cl.getDeclaredField(fieldName) ; 


这 表明 我 们 的 注解 有 点 局 限 。 源 元 素 必 须 是 一 个 成 员 域 的 名 字 ， 而 不 能 是 局 部 变量 。 

代码 的 剩余 部 分 相当 具有 技术 性 。 对 于 每 一 个 被 注解 的 方法 ， 我 们 构造 了 一 个 实现 了 
ActionListener 接口 的 代理 对 象 ， 其 actionPerformed 方法 将 调用 这 个 被 注解 过 的 方 
法 。( 庆 于 代理 的 更 多 信息 见 卷 1 第 6 章 。) 细节 并 不 重要 ， 关 键 要 知道 注解 的 功能 是 通过 
processAnnotations 方法 建立 起 来 的 。 

图 8-1 展示 了 在 本 例 中 注解 是 如 何 被 处 理 的 。 












@ Action 
ListenerFor 


@ Action 
ListenerFor 
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图 8-1 在 运行 时 处 理 注 解 


在 这 个 示例 中 ,注解 是 在 运行 时 进行 处 理 的 。 另 外 也 可 以 在 源码 级 别 上 对 它们 进行 处 
理 ， 这 样 ， 源 代码 生成 器 将 产生 用 于 添加 监听 器 的 代码 。 注 解 也 可 以 在 字 节 码 级 别 上 进行 
理 ， 字 节 码 编辑 器 可 以 将 对 addActionListener 的 调用 注入 到 框 体 构造 器 中 。 听 起 来 似乎 
很 复杂 ， 不 过 可 以 利用 一 些 类 库 相 对 直截了当 地 实现 这 项 任务 。 

对 于 用 户 界 面 程序 员 来 说 ， 我 们 这 个 示例 并 不 能 看 作 是 一 个 严格 意义 上 的 工具 。 因 为 ， 
用 于 添加 监听 上 需 的 实用 方法 对 于 程序 员 来 说 和 添加 一 条 注解 一 样 方便 。( 实 际 上 ，java. 
beans.EventHandler 类 试图 实现 的 就 是 这 样 。 通 过 在 这 个 类 中 提供 一 个 可 以 添加 事件 处 理 
右 的 方法 ， 而 不 仅仅 只 是 构建 它 ， 就 可 以 很 容易 地 对 它 进行 改进 。) 

不 过 ， 这 个 示例 展示 了 对 一 个 程序 进行 注解 以 及 对 这 些 注解 进行 分 析 的 机 制 。 既 然 你 已 
经 领会 了 这 个 具体 示例 ， 那 么 ， 现 在 可 能 已 经 为 后 续 小 节 详 述 注解 语法 做 好 了 更 充分 的 准备 
(这 也 是 我 们 所 希望 的 )。 


a 
ee 
Be 

oy 





e boolean isAnnotationPresent(Class<? extends Annotation> annotationType) 


如 果 该 项 具有 给 定 类 型 的 注解 ， 则 返回 true, 
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e<T extends Annotation> T getAnnotation(Class<T> annotationType) 
获得 给 定 类 型 的 注解 ， 如 果 该 项 不 具有 这 样 的 注解 ， 则 返回 nu11。 

e<T extends Annotation> T[] getAnnotationsByType(Class<T> 
annotationType) 8 
获得 某 个 可 重复 注解 类 型 的 所 有 注解 (查阅 8.5.3 节 )， 或 者 返回 长 度 为 0 的 数组 。 

eAnnotation[] getAnnotations() 
获得 作用 于 该 项 的 所 有 注解 ， 包 括 继承 而 来 的 注解 。 如 果 没 有 出 现任 何 注解 ， 那 么 将 
返回 一 个 长 度 为 0 的 数组 。 

e Annotation[] getDeclaredAnnotations() 
获得 为 该 项 声明 的 所 有 注解 ， 不 包含 继承 而 来 的 注解 。 如 果 没 有 出 现任 何 注解 ， 那 么 
将 返回 一 个 长 度 为 0 的 数组 。 


8.4 注解 语法 

在 本 小 节 ， 我 们 将 介绍 你 必须 了 解 的 注解 语法 。 
8.4.1 注解 接口 

注解 是 由 注解 接口 来 定义 的 : 


modifiers Qinterface AnnotationName 


element Declaration, 
element Declarationy 


} 
每 个 元 素 声明 都 具有 下 面 这 种 形式 : 
type elementName() ; 
或 者 
type elementName() default value; 
举例 来 说 ， 下 面 这 个 注解 具有 两 个 元 素 : assignedTo 和 severity, 
public @interface BugReport 
String assignedTo() default "[none]"; 


int severity(); 


} 

所 有 的 注解 接口 都 隐 式 地 扩展 自 java.lang.annotation.Annotation 接口 。 这 个 接 
口 是 一 个 常规 接口 ， 不 是 一 个 注解 接口 。 请 查看 本 节 最 后 为 该 接口 提供 的 一 些 方 法 所 做 的 
API 注解 。 

你 无 法 扩展 注解 接口 。 换 名 话说， 所 有 的 注解 接口 都 直接 扩展 目 java.1ang.annotation. 


f 
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Annotation, 
你 从 来 不 用 提供 那些 实现 了 注解 接口 的 类 。 
注解 元 素 的 类 型 为 下 列 之 一 : 
o 基本 类 型 (int, short,, long, byte, char, double, float 或 者 boolean)。 


e String. 

eClass (具有 一 个 可 选 的 类 型 参数 ,例如 Class<? extends MyClass), 
e enum 类 型 。 

e 注解 类 型 。 


o 由 前 面 所 述 类 型 组 成 的 数组 (由 数组 组 成 的 数组 不 是 合法 的 元 素 类 型 )。 
下 面 是 一 些 合法 的 元 素 声明 的 例子 : 


public @interface BugReport 
{ 
enum Status { UNCONFIRMED, CONFIRMED, FIXED, NOTABUG }: 
boolean showStopper() default false; 
String assignedTo() default "[none]"; 
Class<?> testCase() default Void.class; 
Status status() default Status. UNCONFIRMED; 
Reference ref() default @Reference(); // an annotation type 
String[] reportedBy(); 





eClass<? extends Annotation> annotationType( ) 
返回 Class 对象， 它 用 于 描述 该 注解 对 象 的 注解 接口 。 注 意 : 调用 注解 对 象 上 的 
getClass 方法 可 以 返回 真正 的 类 ， 而 不 是 接口 。 

e boolean equals(Object other) 
如 果 other 是 一 个 实现 了 与 该 注解 对 象 相同 的 注解 接口 的 对 象 ， 并 且 如 果 该 对 象 和 
other 的 所 有 元 素 彼 此 相等 。 那 么 返回 True, 


e int hashCode() 
返回 一 个 与 equals 方法 兼容 、 由 注解 接口 名 以 及 元 素 值 衍生 而 来 的 散 列 码 。 
e String toString() 
返回 一 个 包含 注解 接口 名 以 及 元 素 值 的 字符 串 表示 ， 例 如 , @BugReport (assignedTo= 


[none], severity=0), 


8.4.2 注解 
每 个 注解 都 具有 下 面 这 种 格式 : 


@AnnotationName(elementName,=value,, elementName =valuez, . . .) 


例如 ， 


@BugReport (assignedTo="Harry", severity=10) 
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元 素 的 顺序 无 关 紧 要 。 下 面 这 个 注解 和 前 面 那个 一 样 。 

BugReport(Severity=10，assignedTo= Harry ) 

如 果 某 个 元 素 的 值 并 未 指定 ， 那 么 就 使 用 声明 的 默认 值 。 例 如 ， 考 虑 一 下 下 面 这 个 注解 : 
@BugReport (severity=10) 

元 素 assignedTo 的 值 是 字符 串 " [none]"。 

O 警告 : 默认 值 并 不 是 和 注解 存储 在 一 起 的 ; 相反 地 ， 它们 是 动态 计算 而 来 的 。 例 如 ， 如 
果 你 将 元 素 assignedTo 的 默认 值 更 改 为 "[]"， 然 后 重新 编译 BugReport 接口 ， 那 么 
注解 @BugReport(severity=10) 将 使 用 这 个 新 的 默认 值 ， 甚 至 在 那些 在 默认 值 修改 之 
前 就 已 经 编译 过 的 类 文件 中 也 是 如 此 。 

有 两 个 特殊 的 快捷 方式 可 以 用 来 简化 注解 。 
如 果 没 有 指定 元 素 ， 要 么 是 因为 注解 中 没有 任何 元 素 ， 要 么 是 因为 所 有 元 素 都 使 用 默认 

值 ， 那 么 你 就 不 需要 使 用 圆 括号 了 。 例 如 ， 

@BugReport 

和 下 面 这 个 注解 是 一 样 的 

@BugReport (assignedTo="[none]", severity=0) 

这 样 的 注解 又 称 为 标记 注解 。 

另外 一 种 快捷 方式 是 单 值 注 解 。 如 果 一 个 元 素 具 有 特殊 的 名 字 value， 并 且 没 有 指定 其 
他 元 素 ， 那 么 你 就 可 以 忽略 掉 这 个 元 素 名 以 及 等 号 。 例 如 ， 既 然 我 们 已 经 在 前 面 将 Action 
ListenerFor 注解 接口 定义 为 如 下 形式 : 


public @interface ActionListenerFor 


{ 
String value(); 


那么 ， 我 们 可 以 将 这 个 注解 书写 成 如 下 形式 : 
@Acti onListenerFor("yellowButton") 


而 不 是 


@ActionListenerFor(value="yel lowButton") 


注意 : 因为 注解 是 由 编译 器 计算 而 来 的 ， 因 此 ， 所 有 元 素 值 必须 是 编译 期 常量 。 例 如 ， 


@BugReport(showStopper=true, assignedTo="Harry", testCase=MyTestCase.class, 
Status=BugReport.Status.CONFIRMED, . . .) 


一 个 项 可 以 有 多 个 注解 : 


@Test 
@BugReport (showStopper=true, reportedBy="Joe") 
public void checkRandomInsertions () 





382 Java SRR Al ZRH 
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如 采 注 解 的 作者 将 其 声明 为 可 重复 的 ， 那 么 你 就 可 以 多 次 重复 使 用 同一 个 注解 : 


@BugReport(showStopper=true, reportedBy="Joe") 
@BugReport(reportedBy={"Harry", "Carl"}) 
public void checkRandomInsertions() 


警告 : 一 个 注解 元 素 永远 不 能 设置 为 nu11， 其 至 不 允许 其 默认 值 为 nu11。 这 样 在 实际 
应 用 中 会 相当 不 方便 。 你 必须 使 用 其 他 的 默认 值 ， 例如 "" 或 者 Void.class。 

如 果 元 素 值 是 一 个 数组 ， 那 么 要 将 它 的 值 用 括号 括 起 来 ， 像 下 面 这 样 : 

@BugReport(. . ., reportedBy={"Harry", "Car]"}) 

如 果 该 元 素 具 有 单 值 ， 那 么 可 以 忽略 这 些 括号 : 

@BugReport(. . ., reportedBy="Joe") // OK, same as {"Joe"} 

既然 一 个 注解 元 素 可 以 是 男 一 个 注解 ， 那么 就 可 以 创建 出 任意 复杂 的 注解 。 例 如 ， 
@BugReport (ref=@Reference(id="3352627"), . . .) 


注意 : 在 注解 中 引入 循环 依赖 是 一 种 错误 。 例 如 ， 因 为 BugReport 具有 一 个 注解 类 型 为 
Reference 的 元 素 ， 所 以 Reference 就 不 能 再 拥有 一 个 类 型 为 BugReport 的 元 素 。 


8.4.3 注解 各 类 声明 


注解 可 以 出 现在 许多 地 方 ， 这 些 地 方 可 以 分 为 两 类 : 声明 和 类 型 用 法 声明 注解 可 以 出 现 


在 下 列 声明 处 : 


e 包 

o 类 (包括 enum) 

o 接口 (包括 注解 接口 ) 

o 方法 

o fiat 

o 实例 域 (包含 enum 常量 ) 

o 局 部 变量 

e 参数 变量 

o 类 型 参数 

对 于 类 和 接口 ， 需 要 将 注解 放置 在 class 和 interface 关键 词 的 前 面 : 


@Entity public class User {... } 
对 于 变量 ， 需 要 将 它们 放置 在 类 型 的 前 面 : 


@SuppressWarnings("unchecked") List<User> users =. ..; 
public User getUser(@Param("id") String userId) 


泛 化 类 或 方法 中 的 类 型 参数 可 以 像 下 面 这 样 被 注解 : 


public class Cache<@Immutable V> { ，，，} 
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注意 ， 对 局 部 变量 的 注解 只 能 在 源码 级 别 上 进行 处 理 。 类 文件 并 不 描述 局 部 变量 。 因 此 ， 
所 有 的 局 部 变量 注解 在 编译 完 一 个 类 的 时 候 就 会 被 遗弃 掉 。 同 样 地 ， 对 包 的 注解 不 能 在 
源码 级 别 之 外 存在 。 


包 是 在 文件 package-info.java 中 注解 的 ， 该 文件 只 包含 以 注解 先导 的 包 语句 。 


/** 

Package-level Javadoc 
@GPL(version="3") 
package com.horstmann, corejava; 
import org.gnu.GPL; 


8.4.4 注解 类 型 用 法 


声明 注解 提供 了 正在 被 声明 的 项 的 相关 信息 。 例 如 ， 在 下 面 的 声明 中 
public User getUser(@NonNull String userId) 
就 断言 userId 参数 不 为 空 。 


注意 : @NonNu11 注解 是 Checker Framework 的 一 部 分 (http://types.cs.washington.edu/ 
checker-framework)。 通 过 使 用 这 个 框架 ， 可 以 在 程序 中 包含 断言 ， 例 如 某 个 参数 不 为 
空 ， 或 者 某 个 String 包含 一 个 正则 表达 式 。 然 后 ， 静 态 分 析 工 具 将 检查 在 给 定 的 源 代码 
段 中 这 些 断言 是 否 有 效 。 


现在 ， 假 设 我 们 有 一 个 类 型 为 List<Stringy 的 参数 ， 并 且 想 要 表示 其 中 所 有 的 字符 
串 都 不 为 nu11。 这 就 是 类 型 用 法 注解 大 显 身手 之 处 ， 可 以 将 该 注解 放置 到 类 型 引 元 之 前 : 
List<@NonNull String>, 

类 型 用 法 注解 可 以 出 现在 下 面 的 位 置 : 

e 与 泛 化 类 型 引 元 一 起 使 用 : List<e@eNonNu11 String>, Comparator .<@NonNul 1 
String> reverseOrder(), 

e 数 组 中 的 任何 位 置 : @NonNu11 String[][] words (words[i][j] J H null), 
String @NonNul] [][] words (words P} null), String[] @NonNul1 1 [] words 
(words[i] 5X null), 

e 与 超 类 和 实现 接口 一 起 使 用 : class Warning extends @Localized Message. 

e 与 构造 器 调用 一 起 使 用 : new @Localized String(. . .)。 

e 与 强制 转型 和 instanceof 检查 一 起 使 用 : (@Localized String) text, if (text 
instanceof @Localized String)。( 这 些 注解 只 供 外 部 工具 使 用 ， 它 们 对 强制 转型 
和 instanceof 检查 不 会 产生 任何 影响 。) 

e 与 异常 规约 一 起 使 用 : public String read() throws @Localized IOException, 

e 与 通配符 和 类 型 边界 一 起 使 用 : List<@Localized ? extends Message>, List<? 


extends @Localized Message>, 
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e 与 方法 和 构造 器 引用 一 起 使 用 : @Localized Message: :getText, 
有 多 种 类 型 位 置 是 不 能 被 注解 的 : 


@NonNull String.class // ERROR: Cannot annotate class literal 
import java.lang.@NonNul] String; // ERROR: Cannot annotate import 


可 以 将 注解 放置 到 诸如 private 和 static 这 样 的 其 他 修饰 符 的 前 面 或 后 面 。 习 惯 (但 
不 入 必需 ) 的 做 法 ， 是 将 类 型 用 法 注解 放置 到 其 他 修饰 符 的 后 面 和 将 声明 注解 放置 到 其 他 修 
饰 符 的 前 面 。 例 如 ， 
private @NonNull String text; // Annotates the type use 
@Id private String userId; // Annotates the variable 
注意 : 注解 的 作者 需要 指定 特定 的 注解 可 以 出 现在 哪里 。 如 果 一 个 注解 可 以 同时 应 用 于 
变量 和 类 型 用 法 ， 并 且 它 确实 被 应 用 到 了 某 个 变量 声明 上 ， 那 么 该 变量 和 类 型 用 法 就 都 
被 注解 了 。 例 如 ， 请 考虑 
public User getUser(@NonNull String userId) 
如 采 @NonNu11 可 以 同时 应 用 于 参数 和 类 型 用 法 ， 那 么 userId 参数 就 被 注解 了 ， 而 其 参 
数 类 型 是 @NonNu11 String。 


8.4.5 注解 this 
假设 想 要 将 参数 注解 为 在 方法 中 不 会 被 修改 。 
public class Point 


public boolean equals(@ReadOnly Object other) {... } 


那么 ， 处 理 这 个 注解 的 工具 在 看 到 下 面 的 调用 时 

p.equals(q) 

号 会 推理 出 q 没有 被 修改 过 。 

但 是 p 呢 ? 

当 该 方法 被 调用 时 ，this 变量 是 绑 定 到 p 的 。 但 是 this 从 来 都 没有 被 声明 过 ， 因 此 你 
无 法 注解 它 。 

实际 上 ， 你 可 以 用 一 种 很 少 用 的 语法 变 体 来 声明 它 ， 这 样 你 就 可 以 添加 注解 了 : 

public class Point 


public boolean equals(@ReadOnly Point this, @ReadOnly Object other) {... } 


第 一 个 参数 被 称 为 接收 器 参数 ， 它 必须 被 命名 为 this ， 而 它 的 类 型 就 是 要 构建 的 类 。 

注意 : 你 只 能 为 方法 而 不 能 为 构造 器 提供 接收 器 参数 。 从 概念 上 讲 ， 构 造 器 中 的 this 
引用 在 构造 器 没有 执行 完 之 前 还 不 是 给 定 类 型 的 对 象 。 所 以 ， 放 置 在 构造 器 上 的 注解 描 
述 的 是 被 构建 的 对 象 的 属性 。 
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传递 给 内 部 类 构造 器 的 是 另 一 个 不 同 的 隐藏 参数 ， 即 对 其 外 围 类 对 象 的 引用 。 你 也 可 以 


让 这 个 参数 显 式 化 : 
public class Sequence 
{ 


private int from; 
private int to; 


class Iterator implements java.util.Iterator<Integer> 


private int current; 


public Iterator(@ReadOnly Sequence Sequence. this) 


{ 


this.current = Sequence. this. from; 


} 


} 


这 个 参数 的 名 字 必 须 像 引 用 它 时 那样 ， 叫 做 EnclosingClass.this， 其 类 型 为 外 围 类 。 


8.5 ”标准 注解 


Java SE 在 java.1ang、java.lang.annotation 和 javax.annotation 包 中 定义 了 
大 量 的 注解 接口 。 其 中 四 个 是 元 注解 ， 用 于 描述 注解 接口 的 行为 属性 ， 其 他 的 三 个 是 规则 接 


口 ， 可 以 用 它们 来 注解 你 的 源 代码 中 的 项 。 


表 8-2 列 出 了 这 些 注解 。 我 们 将 会 在 随后 的 两 个 


小 节 中 给 予 详细 介绍 。 
表 8-2 标准 注解 

注解 接口 应 用 场合 目 的 
Deprecated 全 部 将 项 标记 为 过 时 的 
SuppressWarnings 除了 包 和 注解 之 外 的 所 有 情况 。 阻止 某 个 给 定 类 型 的 警告 信息 
SafeVarargs 方法 和 构造 器 断言 varargs 参数 可 安全 使 用 
Override 方法 检查 该 方法 是 否 覆 盖 了 某 一 个 超 类 方法 
FunctionalInterface 接口 将 接口 标记 为 只 有 一 个 抽象 方法 的 函数 式 接 口 
PostConstruct 方法 被 标记 的 方法 应 该 在 构造 之 后 或 移 除 之 前 立即 被 

PreDestroy 调用 
Resource 类 、 接 口 、 方 法 、 域 在 类 或 接口 上 : 标记 为 在 其 他 地 方 要 用 到 的 资源 。 
在 方法 或 域 上 : 为 “注入 ”而 标记 

Resources 类 、 接 口 一 个 资源 数组 
Generated 全 部 
Target 注解 指明 可 以 应 用 这 个 注解 的 那些 项 
Retention 注解 指明 这 个 注解 可 以 保留 多 久 
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( & ) 
注解 接口 应 用 场合 H 的 
Documented 注解 指明 这 个 注解 应 该 包含 在 注解 项 的 文档 中 
Inherited 注解 指明 当 这 个 注解 应 用 于 一 个 类 的 时 候 ， 能 够 自动 被 
它 的 子 类 继承 
Repeatable 注解 指明 这 个 注解 可 以 在 同一 个 项 上 应 用 多 次 


8.5.1 用 于 编译 的 注解 


@Deprecated 注解 可 以 被 添加 到 任何 不 再 豆 励 使 用 的 项 上 。 所 以 ， 当 你 使 用 一 个 已 过 时 
的 项 时 ， 编 译 右 将 会 发 出 警告 。 这 个 注解 与 Javadoc 标签 edeprecated 具有 同等 功效 。 

@SuppressWarnings 注解 会 告知 编译 器 阻止 特定 类 型 的 警告 信息 ， 例 如 ， 

@SuppressWarnings ("unchecked") 

@0verride 这 种 注解 只 能 应 用 到 方法 上 。 编 译 器 会 检查 具有 这 种 注解 的 方法 是 否 真 正 覆 
盖 了 一 个 来 自 于 超 类 的 方法 。 例 如 ， 如 果 你 声明 : 

public MyClass 


@Override public boolean equals(MyClass other); 


} 

那么 编译 融会 报告 一 个 错误 。 毕 竟 ， 这 个 equals JARAH m Object 类 的 equals 
方法 。 因 为 那个 方法 有 一 个 类 型 为 0bject 而 不 是 MyC1ass 的 参数 。 

@Generated 注解 的 目的 是 供 代 码 生 成 工具 来 使 用 。 任 何 生成 的 源 代 码 都 可 以 被 注解 ， 
从 而 与 程序 员 提 供 的 代码 区 分 开 。 人 例如， 代码 编辑 咒 可 以 隐藏 生成 的 代码 ， 或 者 代码 生成 顺 
可 以 移 除 生成 代码 的 旧版 本 。 每 个 注解 都 必须 包含 一 个 表示 代码 生成 硕 的 唯一 标识 符 ， 而 日 
期 字符 串 〈ISO8601 格式 ) 和 注释 字符 串 是 可 选 的 。 例 如 ， 

@Generated("com.horstmann.beanproperty", "2008-01-04712:08:56.235-0700"); 


8.5.2 用 于 管理 资源 的 注解 


@PostConstruct fil @PreDestroy 注解 用 于 控制 对 象 生 命 周 期 的 环境 中 ， 例 如 Web 容 
器 和 应 用 服务 器 。 标 记 了 这 些 注解 的 方法 应 该 在 对 象 被 构建 之 后 ， 或 者 在 对 象 被 移 除 之 前 ， 
紧 接着 调用 。 

@Resource 注解 用 于 资源 注 人 。 例 如， 考虑 一 下 访问 数据 库 的 Web 应用。 当然 ， 数 据 
库 访问 信息 不 应 该 被 硬 编码 到 Web 应 用 中 。 而 是 应 该 让 Web 容器 提供 某 种 用 户 接口 ， 以 
便 设置 连接 参数 和 数据 库 资 源 的 JNDI 名 字 。 在 这 个 Web 应 用 中 ， 可 以 像 下 面 这 样 引 用 数 
据 源 : 

@Resource(name="jdbc/mydb") 

private DataSource source; 
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当 包含 这 个 域 的 对 象 被 构造 时 ， 容 器 会 “注入 ”一 个 对 该 数据 源 的 引用 。 
8.5.3 ”元 注解 


@Target 元 注解 可 以 应 用 于 一 个 注解 ， 以 限制 该 注解 可 以 应 用 到 哪些 项 上 。 例 如 ， 


@Target({ElementType. TYPE, ElementType.METHOD}) 
public @interface BugReport 


K 8-3 显示 了 所 有 可 能 的 取 值 情况 ， 它 们 属于 枚 举 类 型 E1ementType。 可 以 指定 任意 数 
量 的 元 素 类 型 ， 用 括号 括 起 来 。 


表 8-3 @Target 注解 的 元 素 类 型 


元 素 类 型 注解 适用 场合 元 素 类 型 注解 适用 场合 
ANNOTATION_TYPE 注解 类 型 声明 FIELD 成 员 域 (包括 enum 常量 ) 
PACKAGE 包 PARAMETER 方法 或 构造 器 参数 
TYPE 类 (包括 enum) 及 接口 LOCAL_VARIABLE 局 部 变量 

(包括 注解 类 型 ) 
METHOD 方法 TYPE_PARAMETER 类 型 参数 
CONSTRUCTOR beens TYPE_USE 类 型 用 法 


一 条 没有 @Target 限制 的 注解 可 以 应 用 于 任何 项 上 。 编 译 器 将 检查 你 是 否 将 一 条 注解 只 
应 用 到 了 某 个 允许 的 项 上 。 例 如 ， 如 果 将 @BugReport 应 用 于 一 个 成 员 域 上 ， 则 会 导致 一 个 

@Retention 元 注解 用 于 指定 一 条 注解 应 该 保留 多 长 时 间 。 只 能 将 其 指定 为 表 8-4 中 的 
任意 值 ， 其 默认 值 是 RetentionPolicy.CLASS, 


表 8-4 用 于 @Retention 注解 的 保留 策略 





保留 规则 描 述 

SOURCE 不 包括 在 类 文件 中 的 注解 

CLASS 包括 在 类 文件 中 的 注解 ,但 是 虚拟 机 不 需要 将 它们 载 人 

RUNTIME 包括 在 类 文件 中 的 注解 ， 并 由 虚拟 机 载 人 。 通 过 反射 API 可 获得 它们 


在 程序 清单 8-11 中 ，@ActionListenerFor 注 解 声 明 为 具有 RetentionPolicy. 
RUNTIME ， 因 为 我 们 是 使 用 反射 机 制 进行 注解 处 理 的 。 在 随后 的 两 个 小 节 里 ， 你 将 会 看 到 一 
些 在 源码 级 别 和 类 文件 级 别 上 怎样 对 注解 进行 处 理 的 示例 。 

@Documented 元 注解 为 像 Javadoc 这 样 的 归档 工具 提供 了 一 些 提示 。 应 该 像 处理 其 他 修 
饰 符 (例如 protected 和 static) 一 样 来 处 理 归档 注解 ， 以 实现 其 归档 的 。 其 他 注解 的 使 用 
并 不 会 纳入 归档 的 范畴 。 例 如 ， 假 定 我 们 将 @ActionListenerFor 作为 一 个 归档 注解 来 声明 : 


@Documented 
@Target (El ementType. METHOD) 
@Retention(RetentionPolicy. RUNTIME) 
public @interface ActionListenerFor 
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现在 每 一 个 被 该 注解 标注 过 的 方法 的 归档 就 会 含有 这 条 注解 ， 如 图 8-2 所 示 。 


OP me 


staller || public ButtenFrame() 


| yellowBackground 

| @ActionListenerfor(source="yelloweutton" ) 
public void yellowBackground() 

| blueBackground 

| @ActionListenerFer (source="blueButton”) 

| public void blueBackground() 

| redBackground 


| @ActionListenerfor (source redButton*) 
| Me void peice chsh 





图 8-2 ”文档 化 注解 
如 采 某 个 注解 是 暂时 的 (例如 @BugReport)， 那 么 就 不 应 该 对 它们 的 用 法 进行 归档 。 


注意 : 将 一 个 注解 应 用 到 它 自 身上 是 合法 的 。 例 如 ，@Documented 注解 被 它 自身 注解 为 
@Documented。 因 此 ， 针 对 注解 的 Javadoc 文档 表明 了 它们 是 否 可 以 归档 。 


@Inherited 元 注解 只 能 应 用 于 对 类 的 注解 。 如 果 一 个 类 具有 继承 注解 ， 那 么 它 的 所 有 
子 类 都 自动 具有 同样 的 注解 。 SENUR Serializable 这 样 的 标记 接口 具有 相同 运 
行 方式 的 注解 变 得 很 容易 。 

实际 上 ，@Serializable 注解 应 该 比 没 有 任何 方法 的 Serializable 标记 接口 更 适用 。 
一 个 类 之 所 以 可 以 被 序列 化 ， 是 因为 存在 着 对 它 的 成 员 域 进行 读 写 的 运行 期 支持 ， 而 不 是 因 
为 任何 面向 对 象 的 设计 原则 。 注 解 比 接口 继承 更 擅长 描述 这 一 事实 。 当 然 了 ， 可 序列 化 接口 
是 在 JDK1.1 中 产生 的 ， 远 比 注解 出 现 得 早 。 

假设 定义 了 一 个 继承 注解 @ePersistent 来 指明 一 个 类 的 对 象 可 以 存储 到 数据 库 中 ， 那 
么 该 持久 类 的 子 类 就 会 自动 被 注解 为 是 持久 性 的 。 


@Inherited Qinterface Persistent { } 
@Persistent class Employee {... } 
class Manager extends Employee { . . . } // also @Persistent 


在 持久 化 机 制 去 查找 存储 在 数据 库 中 的 对 和 象 的 时 候 ， 它 就 会 同时 探测 到 Employee 对 象 
以 及 Manager 对 象 。 

对 于 Java SE 8 来 说 ， 将 同 种 类 型 的 注解 多 次 应 用 于 某 一 项 是 合法 的 。 为 了 向 后 兼容 ， 可 
重复 注解 的 实现 者 需要 提供 一 个 容 右 注解 ， 它 可 以 将 这 些 重复 注解 存储 到 一 个 数组 中 。 
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下 面 是 如 何 定义 @TestCase 注解 以 及 它 的 容器 的 代码 : 


@Repeatable(TestCases.class) 
@interface TestCase 


String params () ; 
String expected() ; 
} 


@interface TestCases 


TestCase[] value(); 


无 论 何 时 ， 只 要 用 户 提 供 了 两 个 或 更 多 个 @TestCase 注解 ， 那 么 它们 就 会 自动 地 被 包 
装 到 一 个 @TestCases 注解 中 。 
O SH: 在 处 理 可 重复 注解 时 必须 非常 仔细 。 如 果 调 用 getAnnotation ERRATE 
复 注解 ， 而 该 注解 又 确实 重复 了 ， 那 么 就 会 得 到 nu11。 这 是 因为 重复 注解 被 包装 到 了 容 
器 注解 中 。 
在 这 种 情况 下 ， 应 该 调用 getAnnotationsByType。 这 个 调用 会 “遍历 ”容器 ， 并 给 出 
一 个 重复 注解 的 数组 。 如 果 只 有 一 条 注解 ， 那 么 该 数组 的 长 度 就 为 1。 通 过 使 用 这 个 方 
法 ， 你 就 不 用 操心 如 何 处 理 容器 注解 了 。 


8.6 源码 级 注解 处 理 


在 上 一 节 中 ,你 看 到 了 如 何 分 析 正 在 运行 的 程序 中 的 注解 。 注 解 的 男 一 种 用 法 是 日 动 处 
理 源 代码 以 产生 更 多 的 源 代码 、 配 置 文件 、 脚 本 或 其 他 任何 我 们 想 要 生成 的 东西 。 
8.6.1 注解 处 理 

注解 处 理 已 经 被 集成 到 了 Java 编译 器 中 。 在 编译 过 程 中 ， 你 可 以 通过 运行 下 面 的 命令 来 
调用 注解 处 理 硕 。 

javac -processor ProcessorClassNamey,ProcessorClassName,. . . sourceFiles 

编译 器 会 定位 源 文件 中 的 注解 。 每 个 注解 处 理 器 会 依次 执行 ， 并 得 到 它 表 示 感 兴趣 的 注 
解 。 如 果 某 个 注解 处 理 器 创建 了 一 个 新 的 源 文件 ， 那 么 将 重复 执行 这 个 处 理 过 程 。 如 果 茶 次 
处 理 循环 没有 再 产生 任何 新 的 源 文 件 ， 那 么 就 编译 所 有 的 源 文件 。 
注意 : 注解 处 理 器 只 能 产生 新 的 源 文 件 ， 它 无 法 修改 已 有 的 源 文件 。 

注解 处 理 器 通常 通过 扩展 AbstractProcessor 类 而 实现 Processor 接口 。 你 需要 指 
定 你 的 处 理 器 支持 的 注解 ， 我 们 的 案例 如 下 : 


@SupportedAnnotationTypes("com.horstmann. annotations. ToString’) 
@SupportedSourceVersion(SourceVersion.RELEASE_8) 
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public class ToStringAnnotationProcessor extends AbstractProcessor 


public boolean process(Set<? extends TypeElement> annotations, 
RoundEnvi ronment currentRound) 
{ 


m 
} 


Ah FE 4 Ay D E BA -E Ay yE E A BI oN “ com.horstmann=” jx FE AY 3 BEF (com. 
horstmann 包 及 其 所 有 子 包 中 的 注解 )， 甚 至 是 “*”( 所 有 注解 )。 

在 每 一 轮 中 ，process 方法 都 会 被 调用 一 次 ， 调 用 时 会 传递 给 由 这 一 轮 在 所 有 文件 中 发 
现 的 所 有 注解 构成 的 集 ， 以 及 包含 了 有 关 当 前 处 理 轮 次 的 信息 的 RoundEnvironment 引用 。 


8.6.2 ”语言 模型 API 


应 该 使 用 语言 模型 API 来 分 析 源码 级 的 注解 。 与 呈现 类 和 方法 的 虚拟 机 表示 形式 的 反射 
API 不 同 ， 语 言 模型 API 让 我 们 可 以 根据 Java 语言 的 规则 去 分 析 Java 程序 。 
编译 需 会 产生 一 棵 树 ， 其 节点 是 实现 了 javax.1ang.model.element.Element 接口 
RE TypeElement, VariableElement, ExecutableElement 等 子 接口 的 类 的 实例 。 这 
些 下 点 可 以 类 比 于 编译 时 的 Class, Field/Parament #il Method/Constructor 反射 类 。 
本 书 并 不 会 详细 讨论 该 API， 但 我 们 要 强调 的 是 ， 你 需要 知道 它 是 如 何 处 理 注解 的 。 
eRoundEnvironment 通过 调用 下 面 的 方法 交 给 你 一 个 由 特定 注解 标注 过 的 所 有 元 素 构 
成 的 集 。 


Set<? extends Element> getElementsAnnotatedWith(Class<? extends Annotation> a) 
e 在 源码 级 别 上 等 价 于 AnnotatedE1ement 接口 的 是 AnnotatedConstruct。 使 用 下 
面 的 方法 就 可 以 获得 属于 给 定 注 解 类 的 单条 注解 或 重复 的 注解 。 


A getAnnotation(Class<A> annotationType) 
A[] getAnnotationsByType(Class<A> annotationType) 


e TypeElement 表示 一 个 类 或 接口 ， 而 getEnclosedElements 方法 会 产生 一 个 由 它 的 
域 和 方法 构成 的 列表 。 

e 在 Element 上 调用 getSimp1eName 或 在 TypeElement 上 调用 getQualifiedName 
会 产生 一 个 Name 对 象 ， 它 可 以 用 toString 方法 转换 为 一 个 字符 串 。 


8.6.3 ”使 用 注解 来 生成 源码 


作为 示例 ， 我 们 将 使 用 注解 来 减少 实现 toString 方法 时 枯燥 的 编程 工作 量 。 我 们 不 能 
将 这 些 方法 放 到 原来 的 类 中 ， 因 为 注解 处 理 器 只 能 产生 新 的 类 ， 而 不 能 修改 已 有 类 。 
因此 ， 我 们 将 所 有 方法 添加 到 工具 类 ToStrings 中 : 


public class ToStrings 


public static String toString(Point obj) 
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{ 


Generated code 


public static String toString(Rectangle obj) 
{ 
Generated code 


} 


public static String toString(Object obj) 
{ 
return Objects. toString(ob}) ; 
} 
} 


我 们 不 想 使 用 反射 ， 因 此 对 访问 器 方法 而 不 是 域 进行 注解 : 


@ToString 
public class Rectangle 


{ 


@ToString(includeName=false) public Point getTopLeft() { return topLeft; } 
@ToString public int getWidth() { return width; } 
@ToString public int getHeight() { return height; } 

} 


SRI, TEARADIR AE TAAL AP Te RAS : 


public static String toString(Rectangle obj) 
{ 
StringBuilder result = new StringBuilder() ; 
result.append("Rectangle') ; 
result.append("["); 
result. append(toString (obj .getTopLeft())) ; 
result.append(",'); 
result.append("width=") ; 
result. append(toString(obj .getWidth())) ; 
result.append(",'); 
result. append("height=') ; 
result.append(toString(obj.getHeight())); 
result.append("}"); 
return result, toString() ; 


} 
其 中 ,灰色 的 是 “模板 ”代码 。 下 面 的 框架 所 描述 的 方法 可 以 为 具有 给 定 的 TypeE 1 ement 
的 类 产生 toString 方法 : 


private void writeToStringMethod(PrintWriter out, TypeElement te) 
{ 

String className = te.getQualifiedName().toString() ; 

Print method header and declaration of string builder 

ToString ann = te.getAnnotation(ToString.class) ; 

if (ann.includeName ()) 

Print code to add class name 
for (Element c : te.getEnclosedE] ements ()) 
{ 


ann = c.getAnnotation(ToString.class) ; 


ct 


ct ct et 


oT 
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if (ann != null) 


if (ann.includeName()) Print code to add field name 
Print code to append toString(obj. methodName()) 
} 
} 


Print code to return string 


} 
而 下 面 给 出 的 是 注解 处 理 器 的 process 方法 的 框架 。 它 会 创建 助手 类 的 源 文件 ， 并 为 每 


个 被 注解 标注 的 类 编写 类 头 和 一 个 toString 方法 。 


public boolean process(Set<? extends TypeElement> annotations, 
RoundEnvironment currentRound) 
{ 


if (annotations.size() == 0) return true; 
try 


JavaFileObject sourceFile = processingEnv.getFiler().createSourceFile( 
“com. horstmann. annotations. ToStrings”); 
try (PrintWriter out = new PrintWriter(sourceFile. openWriter())) 
{ 
Print code for package and class 
for (Element e ; currentRound.getE]ementsAnnotatedwith(ToString.class)) 


{ 


if (e instanceof TypeElement) 

{ 
TypeElement te = (TypeElement) e; 
writeToStringMethod(out, te); 

} 


} 
Print code for toString (Object) 


catch (IOException ex) 
{ 


processingEnv.getMessager() .printMessage( 
Kind. ERROR, ex.getMessage()); 


} 
} 


return true; 


} 

对 于 具体 的 那些 显得 有 些 宛 长 的 代码 ， 可 以 去 查看 本 书 代码 。 

注意 ，process 方法 在 后 续 轮 次 中 是 用 空 的 注解 列表 调用 的 ， 然 后 ， 它 会 立即 返回 ， 因 
此 它 并 不 会 多 次 创建 源 文件 。 

首先， 编译 注解 处 理 器 ， 然 后 编译 并 运行 测试 程序 ， 就 像 下 面 这 样 : 


javac sourceAnnotations/ToStringAnnotationProcessor. java 
javac -processor sourceAnnotations.ToStringAnnotationProcessor rect/*.java 
java rect.SourceLevelAnnotationDemo 


人 提示 : 要 想 查看 轮 次 ， 可 以 用 -XprintRounds 标记 来 运行 javac 命令 : 


Round 1: 
input files: {rect.Point, rect.Rectangle, 
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rect. SourceLevelAnnotationDemo} 
annotations: [sourceAnnotations.ToString] 
last round: false 
Round 2: 
input files: {sourceAnnotations.ToStrings} 
annotations: [] 
last round: false 
Round 3: 
input files: {} 
annotations: [] 
last round: true 


这 个 示例 演示 了 工具 可 以 如 何 获取 源 文 件 注解 以 产生 其 他 文件 。 生 成 的 文件 并 非 一 定 要 
是 源 文 件 。 注 解 处 理 器 可 以 选择 生成 XML 描述 符 、 属 性 文件 、Shell 脚本 、HTML 文档 等 。 
注意 : 有 些 人 建议 使 用 注解 来 完成 一 项 更 繁重 的 体力 活 。 如 果 琐 碎 的 获取 器 和 设置 器 可 

以 自动 生成 ， 那 岂 不 是 很 好 ? 例如 ， 用 下 面 的 注解 : 

@Property private String title; 

来 产生 下 面 的 方法 : 


public String getTitle() { return title; } 
public void setTitle(String title) { this.title = title; } 


但 是 ， 这 些 方 法 需要 被 添加 到 同一 个 类 中 。 这 需要 编辑 源 文 件 而 不 是 产生 另 一 个 文件 ， 而 
这 超出 了 注解 处 理 器 的 能 力 范围 。 我 们 可 以 为 实现 此 目的 而 构建 另 一 个 工具 ， 但 是 这 种 工 
具 超 出 了 注解 的 职责 范围 。 注 解 被 设计 为 对 代码 项 的 描述 ， 而 不 是 添加 或 修改 代码 的 指令 。 


8.7” 字 节 码 工程 


你 已 经 看 到 了 我 们 是 怎样 在 运行 期 或 者 在 源码 级 别 上 对 注解 进行 处 理 的 。 还 有 第 3 种 可 
能 : 在 字 节 码 级 别 上 进行 处 理 。 除 非 将 注解 在 源码 级 别 上 删除 ， 否 则 它们 会 一 直 存 在 于 类 文 
件 中 。 类 文件 格式 是 归 过 档 的 (参阅 http://docs .oracle.com/javase/specs/jvms/ 
se8/htm1)， 这 种 格式 相当 复杂 ， 并 且 在 没有 特殊 类 库 的 情况 下 ， 处 理 类 文件 具有 很 大 的 挑 
成 性 。ASM 库 就 是 这 样 的 特殊 类 库 之 一 ， 可 以 从 网 站 http://asm.ow2.org 上 获得 。 


8.7.1 修改 类 文件 
在 本 小 节 ， 我 们 使 用 ASM 向 已 注解 方法 中 添加 日 志 信息 。 如 果 一 个 方法 被 这 样 注解 过 : 
@LogEntry (logger=loggerName) 
那么 ， 在 方法 的 开始 部 分 ， RITER TERRE DT : 
Logger.getLogger(loggerName) .entering(className, methodName) ; 
举例 来 说 ， 如 果 对 Item 类 的 hashCode 方法 做 了 如 下 注解 : 
@LogEntry(logger="global") public int hashCode() 
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那么 ， 在 任何 时 候 调 用 该 方法 ， 都 会 报告 一 条 与 下 面 打印 出 来 的 消息 相似 的 消息 : 


May 17, 2016 10:57:59 AM Item hashCode 
FINER: ENTRY 


为 了 实现 这 项 任务 ， 我 们 需要 遵循 下 面 几 点 : 

1) 加 载 类 文件 中 的 字 节 码 。 

2 ) 定位 所 有 的 方法 。 

3) 对 于 每 个 方法 ， 检 查 它 是 不 是 有 一 个 LogEntry 注解 。 
4) 如 果 有 ， 在 方法 开始 部 分 添加 下 面 所 列 指令 的 字 节 码 : 


Ide loggerName 
invokestatic 
java/util/logging/Logger.getLogger: (Ljava/lang/String;)Ljava/util/logging/Logger; 
ldc className 
ldc methodName 
invokevirtual java/util/logging/Logger.entering: (Ljava/lang/String;Ljava/lang/String;)V 


fh Ax 2625 15 BR A SRE, Rat ASM 却 使 它 变 得 相当 简单 。 我 们 不 会 详细 描述 
和 分 析 插 入 字 节 人 码 的 过 程 。 关 键 之 处 是 程序 清单 8-12 中 的 程序 编辑 了 一 个 类 文件 ， 并 且 在 已 
经 用 LogEntry 注解 标注 过 的 方法 的 开头 部 分 插入 了 日 志 调 用 。 

举例 来 说 ， 下 面 展示 了 应 该 怎样 向 程序 清单 8-13 中 的 Item. java 文件 添加 记录 日 志 指 
S, HF asm 是 安装 ASM 库 的 目录 。 


javac set/Item. java 
javac -classpath .:asm/lib/\* bytecodeAnnotations/EntryLogger. java 
java -classpath .:asm/lib/\* bytecodeAnnotations.EntryLogger set.Item 


在 对 Item 类 文件 被 修改 之 前 和 之 后 分 别 试 运行 一 下 : 
javap -c Set,Itenm 


可 以 看 到 在 hashCode, equals 以 及 compareTo 方法 开始 部 分 插 和 人 的 那些 指令 。 


public int hashCode() ; 
Code: 
0: Ide #85; // String global 
2: invokestatic #80; 
// Method java/util/logging/Logger.getLogger: (Ljava/lang/String;)Ljava/util/logging/Logger; 
5: Ide #86; //String Item 
7: Ide #88; //String hashCode 
9: invokevirtual #84; 
// Method java/util/logging/Logger. entering: (Ljava/lang/String;Ljava/lang/String;)V 
12: bipush 13 
14: aload 0 
15: getfield #2; // Field description:Ljava/lang/String; 
18: invokevirtual #15; // Method java/lang/String.hashCode: ()I 
21: imul 
22: bipush 17 
24: aload 0 
25: getfield #3; // Field partNumber:1 
28: imul 
29: 1add 
30: ireturn 
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程序 清单 8-14 中 的 SetTest 程序 会 将 Item 对 象 插入 到 一 个 散 列 集中 。 当 你 用 修改 过 
的 类 文件 来 运行 该 程序 的 时 候 ， 会 看 到 下 面 的 日 志 记录 信息 : 


May 17, 2016 10:57:59 AM Item hashCode 

FINER: ENTRY 

May 17, 2016 10:57:59 AM Item hashCode 

FINER: ENTRY 

May 17, 2016 10:57:59 AM Item hashCode 

FINER: ENTRY 

May 17, 2016 10:57:59 AM Item equals 

FINER: ENTRY 

[[description=Toaster, partNumber=1729], [description=Microwave, partNumber=4104] ] 


当 将 同一 项 插入 两 次 的 时 候 ， 请 注意 一 下 对 equals 的 调用 。 
这 个 示例 显示 了 字 节 码 工程 的 强大 之 处 : 注解 可 以 用 来 向 程序 中 添加 一 些 指示 ， 而 字 市 
码 编辑 工具 则 可 以 提取 这 些 指 示 ， 然 后 修改 虚拟 机 指令 。 





package bytecodeAnnotations; 


import java.i0.*; 
import java.nio.file.*; 


import org.objectweb.asm,*; 
import org.objectweb.asm. commons. * ; 


oe nu OO Nn A u N e 


/** 
* Adds “entering” logs to all methods of a class that have the LogEntry annotation. 
* @ersion 1.20 2016-05-10 

12 * @author Cay Horstmann 


ka — 
He OO 


3 */ 

14 public class EntryLogger extends ClassVisitor 

15 { 

16 private String className; 

17 

18 /** 

19 * Constructs an EntryLogger that inserts logging into annotated methods of a given class. 
20 * @aram cg the class 

21 */ 


22 public EntryLogger(ClassWriter writer, String className) 


24 super (Opcodes.ASM5, writer); 
25 this.className = className; 
26 } 


2» QOverride 
2 public MethodVisitor visitMethod(int access, String methodName, String desc, 


30 String signature, String[] exceptions) 

31 

32 MethodVisitor mv = cv.visitMethod(access, methodName, desc, signature, exceptions); 
33 return new AdviceAdapter(Opcodes.ASM5, mv, access, methodName, desc) 


34 { 
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private String loggerName; 


public AnnotationVisitor visitAnnotation(String desc, boolean visible) 


{ 


return new AnnotationVisitor(Opcodes.ASM5) 
public void visit(String name, Object value) 


if (desc. equals ("LbytecodeAnnotations/LogEntry;") && name. equals ("logger") 
loggerName = value.toString(); 


i 
} 


public void onMethodEnter() 


{ 
if (loggerName != null) 
{ 


visitLdcInsn(]oggerName) ; 

visitMethodInsn(INVOKESTATIC, "java/util/logging/Logger", "getLogger", 
"(Ljava/lang/String;)Ljava/util/logging/Logger;", false): 

visitLdcInsn(className) ; 

visitLdcInsn(methodName) ; 

visitMethodInsn(INVOKEVIRTUAL, "java/util/logging/Logger", "entering", 
"(Ljava/lang/String;Ljava/lang/String;)V", false); 

loggerName = null; 


/** 


* Adds entry logging code to the given class. 

* @param args the name of the class file to patch 

4 

public static void main(String[] args) throws IOException 


{ 
if (args.length == 0) 
{ 


System.out.print]n("USAGE: java bytecodeAnnotations.EntryLogger classfile"): 
System.exit(1); 


} 
Path path = Paths.get(args[0]); 
ClassReader reader = new ClassReader(Files.newInputStream(path)) ; 
ClassWriter writer = new ClassWriter( 

ClassWriter.COMPUTE_MAXS | ClassWriter.COMPUTE_FRAMES) ; 
EntryLogger entryLogger = new EntryLogger(writer, 

path.toString() .replace(".class", "").replaceAl]l("[/\\\\]", ".")); 
reader.accept(entryLogger, ClassReader. EXPAND FRAMES) : 
Files.write(Paths.get(args(0]), writer. toByteArray()); 
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package set; 


import java.util.*; 
import bytecodeAnnotations.*; 


/** 


* An item with a description and a part number, 
* @ersion 1.01 2012-01-26 
* @author Cay Horstmann 


*/ 


public class Item 


{ 


private String description; 
private int partNumber; 


/** 
* Constructs an item. 
* @param aDescription the item's description 
* @aram aPartNumber the item's part number 
*/ 
public Item(String aDescription, int aPartNumber) 


{ 
description = aDescription; 
partNumber = aPartNumber; 


} 
/** 


* Gets the description of this item. 
* @return the description 

s 
public String getDescription() 


return description; 


} 


public String toStringQ) 
{ 


} 


return "[description=" + description + ", partNumber=" + partNumber + "]"; 


@LogEntry(logger = "com. horstmann") 
public boolean equals (Object otherObject) 
{ 
if (this == otherObject) return true; 
if (otherObject == null) return false; 
if (getClass() != otherObject.getClass()) return false; 
Item other = (Item) otherObject; 
return Objects.equals(description, other.description) && partNumber == other. partNumber; 


} 


@LogEntry(logger = "com. horstmann") 
public int hashCode () 
{ 
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54 return Objects.hash(description, partNumber) ; 












1 package set; 

2 

3 import java.util.*; 

4 import java.util. logging.*; 

5 

6 /** 

7 * @version 1.02 2012-01-26 
8 * @author Cay Horstmann 

$ 


10 public class SetTest 


12 public static void main(String[] args) 


14 Logger.getLogger("com.horstmann") .setLevel (Level. FINEST) ; 
15 Handler handler = new ConsoleHandler(); 

16 handler.setLevel (Level. FINEST) ; 

17 Logger.getLogger("“com.horstmann") .addHandler(handler) ; 
18 

19 Set<Item> parts = new HashSet<>(); 

20 parts.add(new Item("Toaster", 1279)); 

21 parts.add(new Item("Microwave", 4104)); 

22 parts.add(new Item("Toaster", 1279)); 

23 System.out.print]n(parts) ; 

24 } 

25 } 





8.7.2 ”在 加 载 时 修改 字 节 码 


在 前 一 节 中 ， 已 经 看 到 了 一 个 用 于 编辑 类 文件 的 工具 。 不 过 ， 在 把 另 一 个 工具 添加 到 程 
序 的 构建 过 程 中 时 ， 会 显得 策 重 不 堪 。 更 吸引 人 的 做 法 是 将 字 节 码 工 程 延 迟到 载 人 时 ， 即 类 
加 载 磊 加载 类 的 时 候 。 

i 4 (instrumentation) API 提供 了 一 个 安装 字 节 码 转换 器 的 挂钩 。 不 过 ， 必 须 在 程序 的 
main 方法 调用 之 前 安装 这 个 转换 器 。 通 过 定义 一 个 代理 ， 即 被 加 载 用 来 按照 某 种 方式 监视 
程序 的 一 个 类 库 ， 就 可 以 处 理 这 个 需求 。 代 理 代码 可 以 在 premain 方法 中 执行 初始 化 。 

下 面 是 构建 一 个 代理 所 需 的 步骤 : 

1) 实现 一 个 具有 下 面 这 个 方法 的 类 : 

public static void premain(String arg, Instrumentation instr) 

当 加 载 代 理 时 ， 此 方法 会 被 调用 。 代 理 可 以 获取 一 个 单一 的 命令 行 参数 ， 该 参数 是 通过 
arg 参数 传递 进来 的 。instr 参数 可 以 用 来 安装 各 种 各 样 的 挂钩 。 

2) 制作 一 个 清单 文件 EntryLoggingAgent .mf 来 设置 Premain-Class 属性 。 例 如 ， 
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Premain-Class: bytecodeAnnotations.EntryLoggingAgent 


3 ) 将 代理 代码 打包 ， 并 生成 一 个 JAR 文件 ， 例 如 : 


javac -classpath .:asm/lib/\* bytecodeAnnotations/EntryLoggingAgent. java 
jar cvfm EntryLoggingAgent.jar bytecodeAnnotations/EntryLoggingAgent.mf \ 
bytecodeAnnotations/Entry*.class 


为 了 运行 一 个 具有 该 代理 的 Java 程序 ， 请 使 用 下 面 这 个 命令 行 选项 : 
java -javaagent: AgentJARFile=agentArgument ，，， 
举例 来 说 ， 运 行 具 有 实体 日 志 代理 的 SetTest 程序 ， 需 调用 : 


javac set/SetTest.java 
java -javaagent:EntryLoggingAgent.jar=set.Item -classpath .:asm/lib/\* set.SetTest 


Item 参数 是 代理 应 该 修改 的 类 的 名 称 。 

程序 清单 8-15 展示 了 这 个 代理 的 代码 。 该 代理 安装 了 一 个 类 文件 转换 器 ， 这 个 转换 器 首 
先 检验 类 名 是 否 与 代理 参数 相 匹配 。 如 果 匹 配 ， 那 么 它 会 利用 上 一 节 那 个 EntryLogger 类 
修改 字 节 码 。 不 过 ， 修 改过 的 字 节 码 并 不 保存 成 文件 。 相 反 地 ， 转 换 器 只 是 将 它们 返回 ， 以 
加 载 到 虚拟 机 中 (参见 图 8-3 ) 。 换 名 话说， 这 项 技术 实现 的 是 “即时 (just in time)” F 
修改 。 





图 8-3 ”在 加 载 时 修改 类 






package bytecodeAnnotations; 
import java. lang. instrument. *; 


import org.objectweb.asm.*; 


ek 


* @version 1.10 2016-05-10 
* @author Cay Horstmann 
中 


public class EntryLoggingAgent 


o o ~ o Am A wv N 上 一 


p p 
e ë oO 
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13 public static void premain(final String arg, Instrumentation instr) 


15 instr.addTransformer((loader, className, cl, pd, data) -> 
16 

17 if (!className.equals(arg)) return null; 

18 ClassReader reader = new ClassReader (data) : 

19 ClassWriter writer = new ClassWriter( 

20 ClassWriter.COMPUTE_MAXS | ClassWriter.COMPUTE_FRAMES) ， 
21 EntryLogger el = new EntryLogger(writer, className) : 
22 reader.accept(el, ClassReader. EXPAND_FRAMES) ; 

23 return writer. toByteArray(); 

24 }); 

25 } 

26 } 





在 本 章 ， 你 已 经 学 习 到 了 以 下 的 知识 : 

o 怎样 向 Java 程序 中 添加 注解 。 

e 怎样 设计 你 自己 的 注解 接口 。 

e 怎样 实现 可 以 利用 注解 的 工具 。 

你 已 经 看 到 了 三 种 处 理 代码 的 技术 : 编写 脚本 、 编 译 Java 程序 和 处 理 注 解 。 前 两 种 技术 
十 分 简单 。 而 另 一 方面 ， 构 建 注解 工具 可 能 会 很 复杂 ， 但 这 并 非 是 大 多 数 开 发 者 都 需要 解决 
的 问题 。 本 章 向 你 介绍 了 一 些 背景 知识 ， 有 助 于 你 去 理解 可 能 会 碰 到 的 注解 工具 内 部 工作 机 
制 ， 但 这 些 背 景 知识 可 能 会 挫伤 你 自行 开发 工具 的 兴致 。 

在 下 一 章 ， 我 们 将 转向 完全 不 同 的 主题 : 安全 。 安 全 已 经 成 为 Java 平台 的 核心 特征 之 一 。 
由 于 我 们 生存 和 计算 的 世界 变 得 越 来 越 危 险 ， 因 此 透彻 地 理解 Java 安全 对 于 许多 开发 者 来 说 
就 显得 尤为 重要 。 
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A AMA A 数字 签名 
A 安全 管理 天 与 访问 权限 A 加 密 
A 用 户 认证 


当 Java 技术 刚刚 问世 时 ， 令 人 激动 的 并 不 是 因为 它 是 一 种 设计 完美 的 编程 语言 ， 而 是 
因为 它 能 够 安全 地 运行 通过 因特网 传播 的 各 种 applet。 很 显然 ， 只 有 当 用 户 确信 applet 的 代 
码 不 会 破坏 他 的 计算 机 时 ， 用 户 才 会 接受 在 网 上 传播 的 可 执行 的 applet。 因 此 ， 安 全 是 Java 
技术 的 设计 人 员 和 使 用 者 所 关心 的 一 个 重大 问题 。 这 就 意味 着 ，Java 与 其 他 的 语言 和 系统 有 
所 不 同 ， 在 那些 语言 和 系统 中 安全 是 在 事后 才 想 到 要 去 实现 的 ， 或 者 是 对 破坏 的 一 种 应 对 指 
施 ， 而 对 Java 来 说 ， 安 全 机 制 是 一 个 不 可 分 割 的 组 成 部 分 。 

Java 技术 提供 了 以 下 三 种 确保 安全 的 机 制 : 

e 语言 设计 特性 (对 数组 的 边界 进行 检查 ， 无 不 受 检 查 的 类 型 转换 ， 无 指针 算法 等 )。 

e 访问 控制 机 制 ， 用 于 控制 代码 能 够 执行 的 操作 (比如 文件 访问 ， 网 络 访问 等 )。 

e 代码 签名 ， 利 用 该 特性 ， 代 码 的 作者 就 能 够 用 标准 的 加 密 算法 来 认证 Java 代码 。 这 

样 ， 该 代码 的 使 用 者 就 能 够 准确 地 知道 谁 创建 了 该 代码 ， 以 及 代码 被 标识 后 是 否 被 修 
改过 。 

首先 ， 我 们 来 讨论 类 加 载 器 ， 它 可 以 在 将 类 加 载 到 虚拟 机 中 的 时 候 检 查 类 的 完整 性 。 我 
们 将 展示 这 种 机 制 是 如 何 探测 类 文件 中 的 损坏 的 。 

为 了 获得 最 大 的 安全 性 ， 无 论 是 加 载 类 的 默认 机 制 ， 还 是 自 定 义 的 类 加 载 器 ， 都 需要 己 
负责 控制 代码 运行 的 安全 管理 器 类 协同 工作 。 后 面 我 们 还 要 详细 介绍 如 何 配置 Java 平台 的 安 
全 性 。 

最 后 ， 我 们 要 介绍 java.security 包 提 供 的 加 密 算法 ， 用 来 进行 代码 的 标识 和 用 户 吴 
份 认证 。 

与 我 们 的 一 贯 宗旨 一 样 ， 我 们 将 重点 介绍 应 用 程序 编程 人 员 最 感 兴趣 的 话题 。 如 果 要 深 
人 和 研究， 推荐 阅读 Li Gong, Gary Ellison 和 Mary Dageforde 撰写 的 《 Inside Java 2 Platform 
Security: Architecture, API Design, and Implementation 》 一 书 ， 该 书 由 Prentice Hall 出 版 社 于 
2003 年 出 版 。 


9.1 类 加 载 器 
Java 编译 器 会 为 虚拟 机 转换 源 指令 。 虚 拟 机 代码 存储 在 以 .class 为 扩展 名 的 类 文件 中 ， 


‘ 
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每 个 类 文件 都 包含 某 个 类 或 者 接口 的 定义 和 实现 代码 。 这 些 类 文件 必须 由 一 个 程序 进行 解 
释 ， 该 程序 能 够 将 虚拟 机 的 指令 集 翻 译 成 目标 机 器 的 机 器 语言 。 在 以 下 各 节 中 ， 你 将 会 看 到 
虚拟 机 是 如 何 加 载 这 些 类 文件 的 。 


9.1.1 类 加 载 过 程 


请 注意 ， 虚 拟 机 只 加 载 程序 执行 时 所 需要 的 类 文件 。 例 如 ， 假 设 程序 从 MyProgram. 

class 开始 运行 ， 下 面 是 虚拟 机 执行 的 步 又: 

1) 虚拟 机 有 一 个 用 于 加 载 类 文件 的 机 制 ， 例 如 ， 从 磁盘 上 读 取 文件 或 者 请 求 Web 上 的 
文件 ; 它 使 用 该 机 制 来 加 载 MyProgram 类 文件 中 的 内 容 。 
2) WR MyProgram 类 拥有 类 型 为 男 一 个 类 的 域 , 或 者 是 拥有 超 类 ， 那 么 这 些 类 文件 也 

会 被 加 载 。( 加 载 某 个 类 所 依赖 的 所 有 类 的 过 程 称 为 类 的 解析 。) 

3 ) 接着 ， 虚 拟 机 执行 MyProgram 中 的 main 方法 〈 它 是 静态 的 ， 无 需 创 建 类 的 实例 )。 

4) 如 果 main 方法 或 者 main 调用 的 方法 要 用 到 更 多 的 类 ， 那 么 接 下 来 就 会 加 载 这 些 类 。 

然而 ， 类 加 载 机 制 并 非 只 使 用 单个 的 类 加 载 器 。 每 个 Java 程序 至 少 拥 有 三 个 类 加 载 器 : 

o 引导 类 加 载 器 

ef RAM RAS 

e ARAMA (CAML AL AIR ) 

引导 类 加 载 器 负责 加 载 系统 类 (通常 从 JAR 文件 rt.jar 中 进行 加 载 )。 它 是 虚拟 机 不 
可 分 割 的 一 部 分 ， 而 且 通 常 是 用 C 语言 来 实现 的 。 引 导 类 加 载 器 没有 对 应 的 ClassLoader 
对 象 ， 例 如 ， 该 方法 : 

String.class.getClassLoader () 

将 返回 nu11。 
扩展 类 加 载 器 用 于 从 jre/lib/ext 目录 加 载 “标准 的 扩展 ”。 可 以 将 JAR 文件 放 入 该 

目录 ， 这 样 即 使 没有 任何 类 路 径 ， 扩 展 类 加 载 器 也 可 以 找到 其 中 的 各 个 类 。( 有 些 人 推荐 使 用 

该 机 制 来 避免 “可 恶 的 类 路 径 ”， 不 过 请 看 看 下 面 提 到 的 警告 事项 。) 
系统 类 加 载 硕 用 于 加 载 应 用 类 。 它 在 由 CLASSPATH 环境 变量 或 者 -classpath 命令 行 

选项 设置 的 类 路 径 中 的 目录 里 或 者 是 JAR/ZIP 文件 里 查找 这 些 类 。 

在 Oracle 的 Java 语言 实现 中 ， 扩 展 类 加 载 句 和 系统 类 加 载 器 都 是 用 Java 来 实现 的 。 它 

们 都 是 URLC1assLoader 类 的 实例 。 

O BE: 如 果 将 JAR 文件 放 入 jre/lib/ext 目录 中 ， 并 且 在 它 的 类 中 有 一 个 类 需要 调用 
系统 类 或 者 扩展 类 ， 那 么 就 会 遇 到 麻烦 ， 因 为 扩展 类 加 载 器 并 不 使 用 类 路 径 。 在 使 用 扩 
展 目录 来 解决 类 文件 的 冲突 之 前 ， 要 牢记 这 种 情况 

a 注意 : 除了 所 有 已 经 提 到 的 位 置 ， 还 可 以 从 jre/lib/endorsed 目录 中 加 载 类 。 这 种 机 


制 只 能 用 于 将 某 个 标准 的 Java 类 库 替 换 为 更 新 的 版 本 (例如 那些 支持 XML 和 CORBA 
的 类 库 )。 更 多 细节 请 查看 http://docs.oracle.com/javase/7/docs/technotes/guides/standards。 


9.1.2 类 加 载 器 的 层次 结构 


类 加 载 器 有 一 种 父 / 子 关系 。 除 了 引导 类 加 载 嚣 外， 每 个 类 加 载 器 都 有 一 个 父 类 加 载 右 。 
根据 规定 ， 类 加 载 器 会 为 它 的 父 类 加 载 器 提供 一 个 机 会 ， 以 便 加 载 任何 给 定 的 类 ， 并 且 只 有 
在 其 父 类 加 载 器 加 载 失 败 时 ， 它 才 会 加 载 该 给 定 类 。 例 如 ， 当 要 求 系统 类 加 载 器 加 载 一 个 系 
统 类 (比如 ，java.uti1.ArrayList) 时 ， 它 首先 要 求 扩 展 类 加 载 器 进行 加 载 ， 该 扩展 类 
加 载 器 则 首先 要 求 引导 类 加 载 器 进行 加 载 。 引 导 类 加 载 器 会 找到 并 加 载 rt . jar 中 的 这 个 类 ， 
而 无 须 其 他 类 加 载 右 做 更 多 的 搜索 。 

某 些 程序 具有 插件 架构 ， 其 中 代码 的 某 些 部 分 是 作为 可 选 的 插件 打包 的 。 如 果 插 件 被 打 
包 为 JAR 文件 ， 那 就 可 以 直接 用 URLC1assLoader 类 的 实例 去 加 载 这 些 类 。 


URL url = new URL("file:///path/to/plugin.jar") ; 
URLClassLoader pluginLoader = new URLClassLoader(new URL[] { url }); 
Class<?> cl = pluginLoader.loadClass("mypackage.MyClass") ; 


因为 在 URLClassLoader 构造 器 中 没有 
指定 父 类 加 载 器 ， 因 此 pluginLoader 的 父 
亲 就 是 系统 类 加 载 器 。 图 9-1 展示 了 这 种 层 
次 结构 。 

大 多 数 时 候 ， 你 不 必 操 心 类 加 载 的 层次 
结构 。 通 常 ， 类 是 由 于 其 他 的 类 需要 它 而 被 BRDN AN 
加 载 的 ， 而 这 个 过 程 对 你 是 透明 的 。 p 

偶尔 ， 你 也 会 需要 干涉 和 指定 类 加 载 f Hiit 
器 。 考 虑 下 面 的 例子 : ieee eas 

e 你 的 应 用 的 代码 包含 一 个 助手 方法 ， CI | 

€E = Jj FA Class.forName(class-— 
NameString), 
e 这 个 方法 是 从 一 个 插件 类 中 被 调用 的 。 
e mj classNameString 指定 的 正 是 一 
个 包含 在 这 个 插件 的 JAR 中 的 类 。 

插件 的 作者 会 很 合理 地 期 望 这 个 类 应 该 
被 加 载 。 但 是 ， 助 手 方法 的 类 是 由 系统 类 加 
载 器 加 载 的 ， 这 正 是 .Class.forName 所 使 
用 的 类 加 载 器 。 而 对 于 它 来 说 ， 在 插件 JAR 
中 的 类 是 不 可 视 的 ， 这 种 现象 称 为 类 加 载 需 
倒置 。 图 9-1 类 加 载 右 的 层次 结构 

要 解决 这 个 问题 ， 助 手 方法 需要 使 用 恰当 的 类 加 载 器 ， 它 可 以 要 求 类 加 载 器 作为 其 一 个 参 
数 传递 给 它 。 或 者 ， 它 可 以 要 求 将 恰当 的 类 加 载 顺 设 置 成 为 当前 线程 的 上 下 文 类 加 载 逢 ， 这 种 
策略 在 许多 框架 中 都 得 到 了 应 用 (例如 我 们 在 第 3 章 和 第 5 章 讨论 过 的 JAXP Al INDI FEAR) 


a Bootstrap Bo 








404 Java BSRR AI FRHH 


每 个 线程 都 有 一 个 对 类 加 载 器 的 引用 ， 称 为 上 下 文 类 加 载 器 。 主 线程 的 上 下 文 类 加 载 器 
是 系统 类 加 载 器 。 当 新 线程 创建 时 ， 它 的 上 下 文 类 加 载 器 会 被 设置 成 为 创建 该 线程 的 上 下 文 
类 加 载 器 。 因 此 ， 如 果 你 不 做 任何 特殊 的 操作 ， 那 么 所 有 线程 就 都 会 将 它们 的 上 下 文 类 加 载 
fit DLE FEA IN BA 

但 是 ， 我 们 也 可 以 通过 下 面 的 调用 将 其 设置 成 为 任何 类 加 载 器 。 


Thread t = Thread. currentThread(); 
t.setContextC]assLoader(loader) ; 


然后 助手 方法 可 以 获取 这 个 上 下 文 类 加 载 器 : 


Thread t = Thread.currentThread() ， 
ClassLoader loader = t.getContextClassLoader(); 
Class cl = loader. loadClass(className) ; 


当 上 下 文 类 加 载 器 设置 为 插件 类 加 载 器 时 ， 问 题 依旧 存在 。 应 用 设计 者 必须 作出 决策 : 
通常 ， 当 调用 由 不 同 的 类 加 载 器 加 载 的 插件 类 的 方法 时 ， 进 行 上 下 文 类 加 载 器 的 设置 是 一 种 
好 的 思路 ; 或 者 ， 让 助手 方法 的 调用 者 设置 上 下 文 类 加 载 器 。 

G 提示 : 如 果 你 编写 了 一 个 按 名 字 来 加 载 类 的 方法 ， 那 么 让 调用 者 在 传递 显 式 的 类 加 载 器 

和 使 用 上 下 文 类 加 载 器 之 间 进 行 选择 就 是 一 种 好 的 做 法 。 不 要 直接 使 用 该 方法 所 属 的 类 

的 类 加 载 器 。 


每 个 Java 程序 员 都 知道 ， 包 的 命名 是 为 ee 
了 消除 名 字 冲 突 。 在 标准 类 库 中 ， 有 两 个 名 Foata 


为 Date 的 类 ， 它 们 的 实际 名 字 分 别 为 java. 
uti1.Date 和 java.sql1.Date。 使 用 简单 的 名 
字 只 是 为 了 方便 程序 员 ， 它 们 要 求 程 序 包含 
恰当 的 import 语句 。 在 一 个 正在 执行 的 程 
序 中 ， 所 有 的 类 名 都 包含 它们 的 包 名 。 
然而 ， 令 人 人 惊奇 的 是 ， 在 同一 个 虚拟 
机 中 ， 可 以 有 两 个 类 ， 它 们 的 类 名 和 包 名 a 
都 是 相同 的 。 类 是 由 它 的 全 名 和 类 加 载 器 于 
来 确定 的 。 这 项 技术 在 加 载 来 自 多 处 的 代 - 
码 时 很 有 用 。 例 如 ， 浏 览 器 为 每 一 个 Web 
页 都 使 用 了 一 个 独立 的 applet 类 加 载 器 类 
的 实例 。 这 样 ， 虚 拟 机 就 能 区 分 来 自 不 同 
Web 页 的 各 个 类 ， 而 不 用 管 它 们 的 名 字 是 
什么 。 图 9-2 展示 了 一 个 实例 。 假 设 有 一 “weep 
个 Web 页 面包 含 两 个 由 不 同 的 广告 商 提供 ”图 9-2 两 个 类 加 载 器 分 别 加 载 具 有 相同 名 字 的 两 个 类 








的 applet， 其 中 每 个 applet 都 有 一 个 称 为 Banner 的 类 。 因 为 每 个 applet 都 是 由 单独 的 类 加 
载 器 加 载 的 ， 因 此 这 些 类 可 以 彻底 地 区 分 开 而 没有 任何 冲突 。 


注意 : 这 种 技术 还 有 其 他 用 处 ,例如 servlets 和 EJB 的 “ 热 部 署 ”。 详 细 信 息 请 访问 
http://zeroturnaround.com/labs/rjc301 。 


91.4 编写 你 自己 的 类 加 载 器 


RANTS ACM AAT RPA A ASE, OEE ETT AT LAE e EL a 
ZANT eee. BG, RANA WS A aa, ER WB ae RI A REN 
“paid for ”的 类 。 

如 果 要 编写 目 己 的 类 加 载 器 ， 只 需要 继承 ClassLoader 类 ， 然 后 履 盖 下 面 这 个 方法 


findClass(String className) 


ClassLoader 超 类 的 loadClass 方法 用 于 将 类 的 加 载 操作 委托 给 其 父 类 加 载 硕 去 进 
行 ， 只 有 当 该 类 尚未 加 载 并 且 父 类 加 载 器 也 无 法 加 载 该 类 时 ， 才 调用 findC1ass 方法 。 

如 果 要 实现 该 方法 ， 必 须 做 到 以 下 几 点 : 

1 ) 为 来 自 本 地 文件 系统 或 者 其 他 来 源 的 类 加 载 其 字 节 码 。 

2) 调用 ClassLoader 超 类 的 defineClass 方法 ， 回 虚拟 机 提供 字 节 码 。 

在 程序 清单 9-1 中 ， 我 们 实现 了 一 个 类 加 载 器 ， 用 于 加 载 加 密 过 的 类 文件 。 该 程序 要 求 
用 户 输入 第 一 个 要 加 载 的 类 的 名 字 【〈 即 包含 main 方法 的 类 ) 和 密 铀 。 然 后 ， 使 用 一 个 专门 的 
类 加 载 器 来 加 载 指定 的 类 并 调用 main 方法 。 该 类 加 载 器 对 指定 的 类 和 所 有 被 其 引用 的 非 系 
统 类 进行 解密 。 最 后 ， 该 程序 会 调用 已 加 载 类 的 main 方法 (参见 图 9-3 )。 






= m M 
oj es Í % as $ 





Fe A E RAT pa 





® java.lang.ClassFormatérror. incompatible magic value 3388848573 in class fite Catcutator 


图 9-3 ClassLoaderTest 程序 





为 了 简单 起 见 ， 我 们 忽略 了 密码 学 领域 2000 年 来 所 取得 的 技术 进展 ， 而 是 采用 了 传统 
的 Caesar 密码 对 类 文件 进行 加 密 。 


注意 : David Kahn 的 佳作 《 The Codebreakers 》 纽约 Macmillan 出 版 社 1967 年 出 版 ， 
原 书 第 84 页 中 称 Suetonius 是 Caesar 密码 的 发 明 人 。Caesar 将 罗马 字母 表 的 24 个 字母 
移动 了 3 个 字母 的 位 置 ， 在 那个 时 代 这 可 以 迷惑 对 手 。 


r 
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第 一 次 撰写 本 章 时 ， 美 国政 府 限 制 高 强度 加 密 方法 的 出 口 。 因 此 ， 我 们 在 实例 中 使 用 的 
是 Caesar 的 加 密 方法 ， 因 为 该 方法 的 出 口 显 然 是 合法 的 。 


我 们 的 Caesar 密码 版 本 使 用 的 密 钥 是 从 1 ~ 255 之 间 的 一 个 数字 ， 解 密 时 ， 只 需 将 密 钥 与 
每 个 字 节 相 加 ， 然 后 对 256 取 余 。 程 序 清单 9-2 的 Caesar. java 程序 就 实现 了 这 种 加 密 行为 。 

为 了 不 与 常规 的 类 加 载 器 相 混淆 ， 我 们 对 加 密 的 类 文件 使 用 了 不 同 的 扩展 名 .caesar。 

解密 时 ， 类 加 载 器 只 需要 将 每 个 字 节 减 去 该 密 钥 即 可 。 在 本 书 的 程序 代码 中 ， 可 以 找到 
4 个 类 文件 ， 它 们 都 是 用 “3” 这 个 传统 的 密 钥 值 进行 加 密 的 。 为 了 运行 加 密 程序 ， 需 要 使 用 
在 我 们 的 ClassLoaderTest FEF PEX HE KIMERA o 

对 类 文件 进行 加 密 有 很 大 的 用 途 (当然 ,使 用 的 密码 的 强度 应 该 高 于 Caesar 密码 )， 如 果 
没有 加 密 密 钥 ， 类 文件 就 毫 无 用 处 。 它 们 既 不 能 由 标准 虚拟 机 来 执行 ， 也 不 能 轻易 地 被 反 汇编 。 

这 就 是 说 ， 可 以 使 用 定制 的 类 加 载 器 来 认证 类 用 户 的 身份 ， 或 者 确保 程序 在 运行 之 前 已 
经 支付 了 软件 费用 。 当 然 ， 加 密 只 是 定制 类 加 载 器 的 应 用 之 一 。 可 以 使 用 其 他 类 型 的 加 载 需 
来 解决 别 的 问题 ， 例 如 ， 将 类 文件 存储 到 数据 库 中 。 





package classLoader; 

import java.io.*; 

import java.lang.reflect.*; 
import java.nio.file.*; 
import java.awt.*; 

import java.awt.event.*; 
import javax.swing.*; 


o “en Nn 和 Up N p 


10 /** 

1 * This program demonstrates a custom class loader that decrypts class files. 
12 * @version 1.24 2016-05-10 

13 * @author Cay Horstmann 

14 */ 

15 public class ClassLoaderTest 


{ 
17 public static void main(String[] args) 


18 { 

19 EventQueue.invokeLater(() -> 

20 

21 JFrame frame = new ClassLoaderFrame() ; 
22 frame.setTitle("ClassLoaderTest") ; 

23 frame. setDefaul tCloseOperation(JFrame.EXIT_ON_CLOSE) ; 
24 frame. setVisible(true) ; 

25 Wi 

26 } 

27 } 

28 

29 /** 


30 * This frame contains two text fields for the name of the class to load and the decryption key. 


32 Class ClassLoaderFrame extends JFrame 


73 +} 


75 /** 
* This class loader loads encrypted class files. 


private JTextField keyField = new JTextField("3", 4); 

private JTextField nameField = new JTextField("Calculator", 30); 
private static final int DEFAULT_WIDTH = 300; 

private static final int DEFAULT_HEIGHT = 200; 


public ClassLoaderFrame() 


{ 


} 


setSize(DEFAULT_WIDTH, DEFAULT_HEIGHT) ; 

setLayout (new GridBagLayout()); 

add(new JLabel ("Class"), new GBC(0, 0).setAnchor(GBC.EAST)) ; 

add(nameField, new GBC(1, 0).setWeight(100, 0).setAnchor(GBC.WEST)) ; 

add(new JLabel ("Key"), new GBC(0, 1).setAnchor (GBC. EAST)) ; 

add(keyField, new GBC(1, 1).setWeight(100, 0).setAnchor(GBC.WEST)) ; 

JButton loadButton = new JButton("Load"); 

add(loadButton, new GBC(0, 2, 2, 1)); 

loadButton.addActionListener(event -> runClass(nameField.getText(), keyField.getText())); 
pack); 


* Runs the main method of a given class. 

* @param name the class name 

* @param key the decryption key for the class files 
* 


public void runClass(String name, String key) 


{ 


} 


try 


ClassLoader loader = new CryptoClassLoader(Integer.parseInt(key)) ; 
Class<?> c = loader. loadClass (name) ; 

Method m = c.getMethod("main", String[].class); 

m.invoke(null, (Object) new String[] {}); 


catch (Throwable e) 
{ 


JOptionPane.showMessageDialog(this, e); 


} 


78 class CryptoClassLoader extends ClassLoader 


79 { 


private int key; 


/** 
* Constructs a crypto class loader. 
* @param k the decryption key 


public CryptoClassLoader(int k) 
{ 
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88 key = k; 

89 } 

90 

91 protected Class<?> findClass(String name) throws ClassNotFoundException 
92 { 

93 try 

94 { 

95 byte[] classBytes = null; 

96 classBytes = loadClassBytes (name) ; 

97 Class<?> cl = defineClass(name, classBytes, 0, classBytes. length); 
98 if (cl == null) throw new ClassNotFoundException(name) ; 

99 return cl; 

100 

101 catch (IOException e) 

102 

103 throw new ClassNotFoundException (name) ; 

104 } 

15 } 

106 

107  /** 


108 * Loads and decrypt the class file bytes. 

109 * @param name the class name 

110 * @return an array with the class file bytes 

111 */ 

12 private byte[] loadClassBytes(String name) throws I0Exception 


114 String cname = name.replace('.', '/') + ".caesar"; 
115 byte[] bytes = Files. readAl]Bytes(Paths.get(cname)) ; 
116 for (int i = 0; i < bytes.length; i++) 

117 bytes[i] = (byte) (bytes[i] - key); 

118 return bytes; 

19 = SK 

120 } 





package classLoader; 


import java.i0.*: 


* Encrypts a file using the Caesar cipher. 
* @ersion 1.01 2012-06-10 


* @author Cay Horstmann 


i 
2 
3 
4 
5 /** 
6 
7 
8 
9 * 


10 public class Caesar 


u { 

12 public static void main(String[] args) throws Exception 

13 { 

14 if (args.length != 3) 

15 { 

16 System.out.println("USAGE: java classLoader.Caesar in out key"); 
17 return; 


18 } 
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20 try(FileInputStream in = new FileInputStream(args[0]); 
21 FileQutputStream out = new FileQutputStream(args[1])) 
22 { 

23 int key = Integer.parseInt(args([2]); 

24 int ch; 

25 while ((ch = in.read()) != -1) 

26 { 

27 byte c = (byte) (ch + key); 

28 out ,Write(C)， 

29 } 

30 } 

31 } 

32, } 





e ClassLoader getClassLoader() 


ARM BIGR NAIM AE o 





e ClassLoader getParent() 1.2 
RESMA, MRSC NE S| ANAS, MGR Al nu11。 
e static ClassLoader getSystemClassLoader() 1.2 
RRARA Mss, AFRE —T MAA I HE o 
® protected Class findClass(String name) 1.2 
类 加 载 器 应 该 覆盖 该 方法 ， 以 查找 类 的 字 节 码 ， 并 通过 调用 defineClass 方法 将 字 
节 码 传 给 虚拟 机 。 在 类 的 名 字 中 ， 使 用 . 作为 包 名 分 隔 符 ， 并 且 不 使 用 .class HR. 
eClass defineClass(String name, byte[] byteCodeData, int offset, 


int length) 
将 一 个 新 的 类 添加 到 虚拟 机 中 ， 其 字 节 码 在 给 定 的 数据 范围 中 。 





ə URLClassLoader(URL[] urls) 
e URLClassLoader(URL[] urls, ClassLoader parent) 

构建 一 个 类 加 载 器 ， 它 可 以 从 给 定 的 URL 处 加 载 类 。 如 果 URL 以 /结尾 ， 那 么 它 表 
示 的 一 个 目录 ， 否 则 ， 它 表示 的 是 一 个 JAR 文件 。 










e ClassLoader getContextClassLoader() leg 
RRMA, AY BE KHH EAT AAR EN Bk FE YR AE o 


e void setContextClassLoader(ClassLoader loader) 1.2 


+ 
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为 该 线程 中 的 代码 设置 一 个 类 加 载 器 ， 以 获取 要 加 载 的 类 。 如 果 在 启动 一 个 线程 时 没 
有 显 式 地 设置 上 下 文 类 加 载 器 ， 则 使 用 父 线 程 的 上 下 文 类 加 载 器 。 


9.1.5 F BRIE 


当 类 加 载 带 将 新 加 载 的 Java 平台 类 的 字 节 码 传递 给 虚拟 机 时 ， 这 些 字 节 码 首先 要 接受 校 
验 器 〈verifier) 的 校 验 。 校 验 器 负责 检查 那些 指令 无 法 执行 的 明显 有 破坏 性 的 操作 。 除 了 系 
统 类 外 ， 所 有 的 类 都 要 被 校 验 。 

下 面 是 校 验 器 执行 的 一 些 检查 : 

o 变量 要 在 使 用 之 前 进行 初始 化 。 

e 方法 调用 与 对 象 引 用 类 型 之 间 要 匹配 。 

e 访问 私有 数据 和 方法 的 规则 没有 被 违反 。 

e 对 本 地 变量 的 访问 都 落 在 运行 时 堆栈 内 。 

o 运行 时 堆栈 没有 洲 出 。 

如 有 果 以 上 这 些 检查 中 任何 一 条 没有 通过 ， 那 么 该 类 就 被 认为 遭 到 了 破坏 ， 并 且 不 予 加 载 。 
注意 : WRAA Göde 的 定理 ， 那 么 你 可 能 想 知道 ， 校 验 器 究竟 是 如 何 证 明 某 个 类 文件 

不 存在 类 型 不 匹配 、 变 量 没 有 初始 化 和 堆栈 溢出 等 问题 的 。 根 据 G6del 的 定理 ， 你 无 

法 设计 相应 的 算法 ， 使 其 能 够 处 理 程序 文件 ， 并 决定 输入 程序 是 否 有 特定 的 属性 (比如 

不 出 现 堆栈 溢出 问题 )。 这 是 否 属 于 Oracle 公司 的 公共 关系 部 门 和 逻辑 法 则 之 间 的 矛盾 

呢 ? 不 一 事实 上 ， 校 验 器 并 非 是 一 个 G6del 意义 上 的 决策 算法 。 如 果 校 验 器 接受 了 一 个 

程序 ， 那 么 该 程序 就 确实 是 安全 的 。 然 而 ， 也 有 许多 程序 尽管 是 安全 的 ， 但 却 被 校 验 器 

拒绝 了 。( 在 强制 用 哑 元 值 来 初始 化 一 个 变量 时 ， 你 就 会 碰 到 这 个 问题 ， 因 为 编译 器 无 法 

了 解 这 个 变量 是 否 可 以 被 正确 地 初始 化 。) 


这 种 严格 的 校 验 是 出 于 安全 上 的 考虑 ， 有 一 些 偶然 性 的 错误 ， 比 如 变量 没有 初始 化 ， 如 
采 没 有 被 捕获 ， 就 很 容易 对 系统 造成 严重 的 破坏 。 更 为 重要 的 是 ， 在 因特网 这 样 开 放 的 环境 
中 ， 你 必须 保护 上 自己 以 防 恶 意 的 程序 员 对 你 实施 攻击 ， 因 为 他 们 的 目的 就 是 要 造成 恶劣 的 影 
啊 。 例 如 ， 通 过 修改 运行 时 堆栈 中 的 值 ， 或 者 向 系统 对 象 的 私有 数据 字段 写 人 数据 ， 某 个 程 
序 就 会 突破 浏览 器 的 安全 防线 。 

当然 你 可 能 想 知道 ， 为 什么 要 有 一 个 专门 的 校 验 器 来 检查 这 些 特性 呢 。 毕 竟 ， 编 译 器 绝 
不 会 允许 你 生成 一 个 这 样 的 类 文件 : 该 类 文件 中 有 未 初始 化 的 变量 或 者 可 以 通过 另 一 个 类 来 
访问 该 类 的 某 个 私有 数据 字段 。 实 际 上 ， 用 Java 语言 编译 器 生成 的 类 文件 总 是 可 以 通过 校 验 
的 。 然 而 ， 类 文件 中 使 用 的 字 节 码 格式 是 有 很 好 的 文档 记录 的 ， 对 于 具有 汇编 程序 设计 经 验 
并 且 拥 有 十 六 进 制 编辑 器 的 人 来 说 ， 要 手工 地 创建 一 个 对 Java 虚拟 机 来 说 ， 由 合法 的 但 是 不 
安全 的 指令 构成 的 类 文件 ， 是 一 件 非 常 容易 的 事情 。 再 次 提醒 你 ， 要 记 住 ， 校 验 器 总 是 在 防 
范 被 故意 算 改 的 类 文件 ， 而 不 仅仅 只 是 检查 编译 器 产生 的 类 文件 。 

下 面 的 例子 将 展示 如 何 创 建 一 个 变动 过 的 类 文件 。 我 们 从 程序 清单 9-3 的 程序 
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VerifierTest. java 开始 。 这 是 一 个 简单 的 程序 ， 它 调用 一 个 方法 ， 并 且 显 示 方 法 的 运行 
结果 。 该 程序 既 可 以 在 控制 台 运 行 ， 也 可 以 作为 一 个 applet 程序 来 运行 。 其 中 的 fun 方法 本 
身 只 是 负责 计算 1+2。 

static int fun() 


int m; 

int n; 

m= 1; 

n= 2: 

int r=m+n; 
return r; 


} 
作为 一 次 实验 ， 请 尝试 编译 下 面 这 个 对 该 程序 进行 修改 后 的 文件 。 


static int fun() 


int m= 1; 

int n; 

m= 1; 

a= 2: 

int r=m+n; 
return r; 


在 这 种 情况 下 , n 没有 被 初始 化 ， 它 可 以 是 任何 随机 值 。 当 然 ， 编 译 器 能 够 检测 到 这 个 
问题 并 拒绝 编译 该 程序 。 如 果 要 建立 一 个 不 良 的 类 文件 ， 我 们 必须 得 多 花 点 工夫 。 首 先 ， 运 
行 javap 程序 ， 以 便 知 晓 编译 器 是 如 何 翻译 fun 方法 的 。 下 面 这 个 命令 : 


javap -c verifier.VerifierTest 


用 助 记 (mnemonic) 格式 显示 了 类 文件 中 的 字 节 但 。 


Method int funQ 
0 iconst_l 
1 istore_0 
2 iconst_2 
3 istore_l 
4 iload_0 
5 iload_1 
6 iadd 
7 istore_2 
8 iload_2 
9 jreturn 


我 们 使 用 一 个 十 六 进 制 编辑 器 将 指令 3 从 istore 1 改 为 istore 0， 也 就 是 说 ， 局 部 变 
量 0 ( 即 m) 被 初始 化 了 两 次 ， 而 局 部 变量 1 ( 即 n) 则 根本 没有 初始 化 。 我 们 必须 知道 这 些 
指令 的 十 六 进 制 值 ， 这 些 值 在 Tim Lindholm 和 Frank Yellin 撰写 的 « The Java Virtual Machine 
Specification 》 一 书 中 很 容易 就 可 以 找到 ， 该 书 由 Addison-Wesley 出 版 社 于 1999 年 出 版 。 


0 iconst_1 04 
1 istore_0 3B 
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2 iconst_2 05 
3 1store 1 3C 
4 iload 0 1A 
5 iload_1 1B 
6 iadd 60 
7 istore_2 3D 
8 iload.2 1C 
9 ireturn AC 


可 以 使 用 任何 十 六 进 制 编 辑 器 来 执行 这 种 修改 。 在 图 9-4 中 ， 你 可 以 看 到 类 文件 
VerifierTest.class 被 加 载 到 了 Gnome 编辑 器 中 ，fun 方法 的 字 节 码 已 经 被 选 定 。 


VerifierlTest.class - GHe 


00 19 B2 00 10 BB OO 16 59 12°18 B7 00 
21 00 25 B6 00 29 B1 00 00 00 

02 00 00 00 13 00 18 00 14 

00 00 00 19 00 2E 00 2F 00 

01 00 07 00 00 00 54 00 02 


a8 03 3L IA 18 50 3D IC AC 00 
12 00 04 00 00 00 1E 00 02 
00 22 00 OB 00 00 00 20 00 
31 00 00 00 04 00 06 OO 32 
00 33 00 31 00 02 00 01 00 
00 00 53 00 04 00 02 00 00 
18 B7 00 1A B8 OO 1D B6 00 
B6 00 36 B1 00 00 00 02 00 
00 00 27 OO 1A 00 28 OO OB 
00 1B 00 OC 00 OD 00 00 00 
01 00 01 00 3E 00 00 86 02 00 3F 





图 9-4 ”使 用 十 六 进 制 编辑 器 修改 字 节 码 


将 3C 改 为 3B 并 保存 类 文件 。 然 后 尝试 运行 Verifiertest 程序 ， 将 会 看 到 下 面 的 出 
错 信 息 : 


Exception in thread "main" java.lang.VerifyError: (class: VerifierTest, method:fun signature: 
()I) Accessing value from uninitialized register 1 


这 很 好 一 一 虚拟 机 发 现 了 我 们 所 做 的 修改 。 

现在 用 -noverify 选项 (或 者 -Xverify:none) 来 运行 程序 : 

java -noverify verifier.VerifierTest 

从 表面 上 看 ，fun 方法 似乎 返回 了 一 个 随机 值 。 但 实际 上 ， 该 值 是 2 与 存储 在 尚未 初始 
化 的 变量 n 中 的 值 相 加 得 到 的 结果 。 下 面 是 典型 的 输出 结果 : 

1 + 2 == 15102330 


为 了 观察 浏览 器 是 如 何 处 理 校 验 的 ， 我 们 编写 的 这 段 程 序 ， 既 可 以 作为 一 个 应 用 程序 来 
运行 ， 也 可 以 作为 一 个 applet 来 运行 。 把 applet 加 载 到 浏览 器 中 ， 并 使 用 一 个 文件 URL 来 





访问 ， 
file:///C:/CoreJavaBook/v2ch9/verifier/VerifierTest. html 
这 时 ， 就 会 出 现 一 个 出 错 消 息 ， 这 表明 校 验 失败 了 (参见 图 9-5 )。 
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» * e Cy a ao E fie harefeayfookaeeodeh2en05)erherTostVerherTest htm 
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r: reload policy configuration 
s: dump system and deployment properties 
t: dump thread list 

v: dump thread stack 

x: clear classloader cache 

0-5: set trace level to <n> 


java.lang.VerifyError: (class: VerifierTest, method: fun signature: ()I) Accessing value from uninitialized register 1 
at java.lang.Class.getDeclaredConstructorsO(Native Method) 
at java.lang.Class.privateGetDeclaredConstructors(Class java:2389) 
at java.lang.Class.getConstructor0(Class java:2699) 
at java Jang.Class.newinstanceO(Class java:326) 
at java.lang.Class.newinstance(Class .java:308) 
at sun.applet AppletPanel.createApplet(AppletPanel java:779) 
at sun.plugin.AppletViewer.createApplet(Applet Viewer java:2070) 
at sun.applet AppletPanel.runLoader{AppletPanel java:708) 
at sun.applet AppletPanel.run(AppletPanel java:362) 
at java lang, Thread.run(Thread java:619) 





package verifier; 


import java.applet.*; 
import java.awt.*; 


/** 

* This application demonstrates the bytecode verifier of the virtual machine. If you use a hex 
* editor to modify the class file, then the virtual machine should detect the tampering. 

* @version 1.00 1997-09-10 

* @author Cay Horstmann 

gi 

public class VerifierTest extends Applet 

{ 


public static void main(String[] args) 


{ 
} 
/** 


* A function that computes 1 + 2. 

* @return 3, if the code has not been corrupted 
J 

public static int fun() 


System.out.printin("1 + 2 == " + fun()); 
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24 { 

25 int m; 

26 int n; 

27 me 1: 

28 n = 2; 

29 // use hex editor to change to "m = 2" in class file 
30 intr=m+n; 

31 return r; 

32 } 


34 public void paint(Graphics g) 


36 g.drawString("1 + 2 == "+ fun(), 20, 20); 
} 


92 ”安全 管理 器 与 访问 权限 


一 旦 东 个 类 被 加 载 到 虚拟 机 中 ， 并 由 检验 器 检查 过 之 后 ，Java 平台 的 第 二 种 安全 机 制 就 
会 启动， 这 个 机 制 就 是 安全 管理 器 。 下 面 几 节 将 讨论 这 种 机 制 。 


9.2.1 权限 检查 


安全 管理 硕 是 一 个 负责 控制 具体 操作 是 否 允 许 执行 的 类 。 安 全 管理 器 负责 检查 的 操作 包 
括 以 下 内 容 : 

o 创建 一 个 新 的 类 加 载 器 

o 退出 虚拟 机 

o 使 用 反射 访问 另 一 个 类 的 成 员 

o 访问 本 地 文件 

o 打开 socket 连接 

e 启动 打印 作业 

o 访问 系统 剪贴 板 

e 访问 AWT 事件 队列 

e 打开 一 个 顶层 窗口 

整个 Java 类 库 中 还 有 许多 其 他 类 似 的 检查 。 

在 运行 Java 应 用 程序 时 ， 上 默认 的 设置 是 不 安装 安全 管理 器 的 ， 这 样 所 有 的 操作 都 是 允许 
的 。 为 一 方面 ，applet 浏览 器 会 执行 一 个 功能 受 限 的 安全 策略 。 

PIG, applet 不 允许 退出 虚拟 机 。 如 果 它 们 试图 调用 exit 方法 ， 就 会 抛 出 一 个 安全 异 
常 。 下 面 将 详细 说 明 这 种 情况 。Runtime 类 的 exit 方法 会 调用 安全 管理 器 的 checkExit 
方法 ， 下 面 是 exit 方法 的 全 部 代码 : 

public void exit(int status) 


SecurityManager security = System. getSecurityManager() ; 
if (security != null) 


security. checkExit (status) ; 
exitInternal (status) ; 


这 时 安全 管理 器 要 检查 退出 请 求 是 来 自 浏览 器 还 是 单个 的 applet FEF. MR at 
同意 了 退出 请 求 ， 那 么 checkExit 便 直 接 返回 并 继续 处 理 下 面 正常 的 操作 。 但 是 ， 如 采 安 
全 管理 器 不 同意 退出 请 求 ， 那 么 checkExit 方法 就 会 抛 出 一 个 SecurityException Fi} 

只 有 当 没 有 任何 异常 发 生 时 ，exit 方法 才能 继续 执行 。 然 后 它 调用 本 地 私有 的 exit 
Internal 方法 ， 以 真正 终止 虚拟 机 的 运行 。 没 有 其 他 的 方法 可 以 终止 虚拟 机 的 运行 ， 因 为 
exitInternal 方法 是 私有 的 ， 任 何其 他 类 都 不 能 调用 它 。 因 此 ， 任 何 试图 退出 虚拟 机 的 代 
码 都 必须 通过 exit 方法 ， 从 而 在 不 触发 安全 异常 的 情况 下 ， 通 过 checkExit 安全 检查 。 

显然 ， 安 全 策略 的 完整 性 依赖 于 谨慎 的 编码 。 标 准 类 库 中 系统 服务 的 提供 者 ， 在 试图 继 
续 任 何 敏 感 的 操作 之 前 ， 都 必须 与 安全 管理 器 进行 协商 。 

Java 平台 的 安全 管理 器 ， 不 仅 人 允许 系统 管理 员 ， 而 且 允 许 程序 员 对 各 个 安全 访问 权限 实 
施 细致 的 控制 。 我 们 将 在 下 一 节 介 绍 这 些 特 性 。 首 先 ， 我 们 将 介绍 Java 2 平台 的 安全 模型 的 
概况 ， 然 后 介绍 如 何 使 用 策略 文件 对 各 个 权限 实施 控制 。 最 后 ， 我 们 要 介绍 如 何 来 定义 你 目 
己 的 权限 类 型 。 
注意 : 实现 并 安装 自己 的 安全 管理 器 是 可 行 的 ， 但 是 你 不 应 该 进行 这 种 尝试 ， 除 非 你 是 

计算 机 安全 方面 的 专家 。 配 置 标准 的 安全 管理 器 更 加 安全 。 


92.2 Java 平台 安全 性 


JDK 1.0 具有 一 个 非常 简单 的 安全 模型 ， 即 本 地 类 拥有 所 有 的 权限 ， 而 远程 类 只 能 在 沙 
合 里 运行 。 就 像 儿童 只 能 在 沙 愈 里 玩 沙子 一 样 ， 远 程 代码 只 被 允许 打印 屏幕 和 与 用 户 进行 交 
互 。applet 的 安全 管理 器 拒绝 了 远程 代码 对 本 地 资源 的 所 有 访问 。JDK 1.1 对 此 进行 了 微小 的 
修改 ， 如 果 远 程 代码 带 有 可 信赖 的 实体 的 签名 ， 将 被 赋予 和 本 地 类 相同 的 访问 权限 。 不 过 ， 
JDK 1.0 和 1.1 这 两 个 版 本 提供 的 都 是 一 种 “要 么 都 有 ， 要 么 都 没有 ”的 权限 赋予 方法 。 程 序 
要 么 拥有 所 有 的 访问 权限 ， 要 么 必须 在 沙 盒 里 运行 。 

从 Java SE 1.2 开始 ，Java 平 台 拥 有 了 更 灵活 的 安全 机 制 ， 它 的 安全 策略 建立 了 代码 来 源 
和 访问 权限 集 之 间 的 映射 关系 (参见 图 9-6 )。 

代码 来 源 (code source) 是 由 一 个 代码 位 置 和 一 个 证 书 集 指定 的 。 代 码 位 置 指定 了 代码 
的 来 源 。 例 如 ， 远 程 .applet 代码 的 代码 位 置 是 下 载 applet 的 HTTP URL, 位 于 JAR 文件 中 的 
代码 的 代码 位 置 是 该 文件 的 URL. 证 书 的 目的 是 要 由 某 一 方 来 保障 代码 没有 被 算 改 过 。 我 们 
将 在 本 章 的 后 面部 分 讨论 证 书 。 

权限 (permission) 是 指 由 安全 管理 器 负责 检查 的 任何 属性 。Java 平台 支持 许多 访问 权限 
类 ， 每 个 类 都 封装 了 特定 权限 的 详细 信息 。 例 如 ， 下 面 这 个 FilePermission 类 的 实例 表 
A: 允许 在 /tmp 目录 下 读 取 和 写 人 任何 文件 。 


FilePermission p = new FilePermission("/tmp/*", "read,write’); 


i 
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图 9-6 一 个 安全 策略 


更 为 重要 的 是 ，Policy 类 的 默认 实现 可 从 访问 权限 文件 中 读 取 权限 。 在 权限 文件 中 ， 
同样 的 读 权限 表示 为 : 


permission java.io.FilePermission "/tmp/*", "read,write": 
我 们 将 在 下 一 节 介 绍 权限 文件 。 
图 9-7 显示 了 Java SE 1.2 中 提供 的 权限 类 的 层次 结构 。JDK 的 后 续 版 本 添加 了 更 多 的 权限 类 。 
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图 9-7 权限 类 的 层次 结构 


在 上 一 节 中 ， 我 们 看 到 了 SecurityManager 类 有 许多 诸如 checkExit 的 安全 检查 方 
法 ， 这 些 方 法 的 存在 ， 只 是 为 了 程序 员 的 方便 和 向 后 的 兼容 性 ， 它 们 都 已 被 映射 为 标准 的 权 
限 检 查 ， 例 如 ， 下 面 是 checkExit 方法 的 源 代码 : 


public void checkExit() 





checkPermission(new RuntimePermission("exitVM")) ; 


} 

每 个 类 都 有 一 个 保护 域 ， 它 是 一 个 用 于 封装 类 的 代码 来 源 和 权限 集合 的 对 象 。 当 Security 
Manager 类 需要 检查 某 个 权限 时 ， 它 要 查看 当前 位 于 调用 堆栈 上 的 所 有 方法 的 类 ， 然 后 它 要 获 
得 所 有 类 的 保护 域 ， 并 且 询 问 每 个 保护 域 ， 其 权限 集合 是 否 允 许 执行 当前 正在 被 检查 的 操作 。 
如 果 所 有 的 域 都 同意 ， 那 么 检查 得 以 通过 。 否 则 ， 就 会 抛 出 一 个 SecurityException 异常 。 

为 什么 在 调用 堆栈 上 的 所 有 方法 都 必须 允许 某 个 特定 的 操作 呢 ? 让 我 们 通过 一 个 实例 来 
说 明 这 个 问题 。 假 设 一 个 applet 的 init 方法 想 要 打开 一 个 文件 ， 它 可 能 会 调用 下 面 的 语句 : 

Reader in = new FileReader(name) ; 

FileReader 构造 器 调用 FileInputStream 构造 器 ， 而 FileInputStream 构 造船 调 
用 安全 管理 器 的 checkRead 方法 ， 安 全 管理 器 最 后 用 FilePermission(Cname， "read ) 
对 象 调 用 checkPermission。 表 9-1 显示 了 该 调用 堆栈 。 


表 9-1 权限 检查 期 间 的 调用 堆栈 


类 方 法 代码 来 源 权 R 
SecurityManager checkPermission null AliPermission 
SecurityManager checkRead null AllPermission 
FileInputStream Constructor nul] AllPermission 
FileReader Constructor null AllPermission 
Applet init Applet 代码 来 源 Applet 权限 





FileInputStream 和 SecurityManager 类 都 属于 系统 类 ， 它们 的 CodeSource 为 
nu11， 它 们 的 权限 都 是 由 A11Permission 类 的 一 个 实例 组 成 的 ，A11Permission 类 人 允许 
执行 所 有 的 操作 。 显 然 地 ， 仅 仅 根据 它们 的 权限 是 无 法 确定 检查 结果 的 。 正 如 我 们 所 看 到 的 
那样 ，checkPermission 方法 必须 考虑 applet 类 的 受 限制 的 权限 问题 。 通 过 检查 整个 调 
用 堆栈 ， 安 全 机 制 就 能 够 确保 一 个 类 决 不 会 要 求 另 一 个 类 代表 自己 去 执行 某 个 敏感 的 操作 。 


注意 : 上 面 关 于 如 何 进行 权限 检查 的 简要 介绍 ， 向 你 展示 了 这 方面 的 基本 概念 。 不 过 我 
们 在 这 里 省 略 了 对 许多 技术 细节 的 说 明 。 对 于 安全 性 的 细节 问题 ， 我 们 建议 你 阅读 Li 
Gong 撰写 的 著作 ， 以 便 了 解 更 多 的 内 容 。 有 关 Java 平台 安全 模型 的 更 多 重要 信息 ， 请 
查 阅 Gary McGraw 和 Ed Felten # 写 的 《 Securing Java: Getting Down to Business with 
Mobile Code, # 20k) —#, GHW Wiley 出 版 社 于 1999 年 出 版 。 你 可 以 在 下 面 的 网 
站 上 找到 该 书 的 在 线 版 本 : http://www. securing java.com o 





e void checkPermission(Permission p) 1.2 
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检查 当前 的 安全 管理 器 是 否 授予 给 定 的 权限 。 如 果 没 有 授予 该 权限 ， 本 方法 抛 出 一 个 
SecurityException 异常 。 





epProtectionDomain getProtectionDomain() 1.2 


获取 该 夫 的 保护 域 ， 如 果 该 类 被 加 载 时 没有 保护 域 ， 则 返回 nu11。 





èe ProtectionDomain(CodeSource source, PermissionCollection permissions) 


用 给 定 的 代码 来 源 和 权限 构建 一 个 保护 域 。 


e CodeSource getCodeSource() 


获取 该 保护 域 的 代码 来 源 。 


e boolean implies(Permission p) 


如 果 该 保护 域 允 许 给 定 的 权限 ， 则 返回 true, 





eCertificate[] getCertificates() 
获取 与 该 代码 来 源 相 关联 的 用 于 类 文件 签名 的 证 书 链 。 
e URL getLocation() 
获取 与 该 代码 来 源 相关 联 的 类 文件 代码 位 置 。 


9.2.3 ”安全 策略 文件 


策略 管理 需要 读 取 相 应 的 策略 文件 ， 这 些 文件 包含 了 将 代码 来 源 映 射 为 权限 的 指令 。 下 
面 是 一 个 典型 的 策略 文件 : 
grant codeBase "http://ww.horstmann.com/classes" 


permission java.io.FilePermission "/tmp/*", "read,write": 


该 文件 给 所 有 下 载 自 http:/www.horstmann.com/classes 的 代码 授予 在 / tmp 目录 下 读 取 
和 写 人 文件 的 权限 。 

可 以 将 策略 文件 安装 在 标准 位 置 上 。 默 认 情 况 下 ， 有 两 个 位 置 可 以 安装 策略 文件 : 

e Java 平台 主 目录 的 java.policy 文件 。 

e 用 户主 目录 的 .java.policy 文件 (注意 文件 名 前 面 的 圆 点 )。 


注意 : 可 以 在 java.security 配置 文件 中 修改 这 些 文件 的 位 置 ， 默 认 位 置 设 定 为 ， 


policy.url.1=file:${java.home}/lib/security/java. policy 
policy.url.2=file:${user.home}/.java.policy 


系统 管理 员 可 以 修改 java.security 文件 ， 并 可 以 指定 驻 留 在 另外 一 台 服 务 器 上 并 且 


用 户 无 法 修改 的 策略 URL。 策 略 文件 中 允许 存放 任何 数量 的 策略 URL (这 些 URL 带 有 
连续 的 编号 ) 。 所 有 文件 的 权限 都 被 组 合 了 在 一 起 。 

如 果 你 想 将 策略 文件 存储 到 文件 系统 之 外 ， 那 么 可 以 去 实现 Policy 类 的 一 个 子 类 ， 
让 其 去 收集 所 允许 的 权限 。 然 后 在 java.security 配置 文件 中 更 改 下 面 这 行 : 
policy.provider=sun.security.provider.PolicyFile 
在 测试 期 间 ， 我 们 不 喜欢 经 常 地 修改 这 些 标 准 文件 。 因 此 ， 我 们 更 愿意 为 每 一 个 应 用 和 三 

序 单独 命名 策略 文件 ， 这 样 将 权限 写 人 一 个 独立 的 文件 (比如 MyApp.policy) 中 即 可 。 要 

应 用 这 个 策略 文件 ， 可 以 有 两 个 选择 。 一 种 是 在 应 用 程序 的 main 方法 内 部 设置 系统 属性 : 
System. setProperty("java.security.policy", "MyApp.policy") ; 

或 者 ， 可 以 像 下 面 这 样 局 动 虚拟 机 : 

java -Djava.security.policy=MyApp.policy MyApp 

对 于 applet， 则 可 以 用 如 下 的 启动 命令 。 

appletviewer -J-Djava.security.policy=MyApplet.policy MyApplet. html 

(可 以 用 appletviewer 的 -J 选项 将 任何 命令 行 参 数 传 给 虚拟 机 )。 

在 这 些 例 子 中 ，MyApp . policy 文件 被 添加 到 了 其 他 有 效 的 策略 中 。 如 果 在 命令 行 中 洪 

加 了 第 二 个 等 号 ， 比 如 : 
java -Djava, security. policy==MyApp.policy MyApp 
那么 应 用 程序 就 只 使 用 指定 的 策略 文件 ， 而 标准 策略 文件 将 被 忽略 。 

O BE: 在 测试 期 间 ， 一 个 容易 犯 的 错误 是 在 当前 目录 中 留 T 了 一 个 .java.policy SAF, 
该 文件 授予 了 许 许多 多 的 权限 ， 甚 至 可 能 授予 了 A11Permission。 如 果 发 现 你 的 应 用 
程序 似乎 没有 应 用 策略 文件 中 的 规定 ， 就 应 该 检查 当前 目录 下 是 否 留 有 .java.policy 
文件 。 如 果 使 用 的 是 UNIX 系统 ， 就 更 容易 犯 这 样 的 错误 ， 因 为 在 UNIX 中 ,文件 名 以 
圆 点 开头 的 文件 默认 是 不 显示 的 。 
正如 前 面 所 说 ， 在 默认 情况 下 ，Java 应 用 程序 是 不 安装 安全 管理 器 的 。 因 此 ， 在 安放 安 

全 管理 器 之 前 ， 看 不 到 策略 文件 的 作用 。 当 然 ， 可 以 将 这 行 代码 : 

System. setSecurityManager(new SecurityManager()) ; 

添加 到 main 方法 中 ， 或 者 在 启动 虚拟 机 的 时 候 添 加 命令 行 选项 -Djava.security、 
manager。 

java -Djava.security.manager -Djava.security.policy=MyApp.policy MyApp 

在 本 节 的 剩余 部 分 ， 我 们 将 要 详细 介绍 如 何 描述 策略 文件 的 权限 。 我 们 将 介绍 整个 策略 
文件 的 格式 ， 不 过 不 包括 代码 证 书 部 分 ， 代 码 证 书 将 在 本 章 的 后 面部 分 介绍 。 

一 个 策略 文件 包含 一 系列 -grant 项 。 每 一 项 都 具有 以 下 的 形式 : 


grant codesource 
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{ 
permission, 
permission; 
ho. 
代码 来 源 包含 一 个 代码 基 〈 如 果 某 一 项 适用 于 所 有 来 源 的 代码 ， 则 代码 基 可 以 省 略 ) 和 值 
得 信赖 的 用 户 特征 (principal) 与 证 书签 名 者 的 名 字 (如 果 不 要 求 对 该 项 签名 ， 则 可 以 省 略 )。 
代码 基 可 以 设 定 为 : 
codeBase "url" 


WR URL 以 “/” 结束， 那么 它 是 一 个 目录 。 和 否则 ， 它 将 被 视 为 一 个 JAR 文件 的 名 字 。 例 如 ， 


grant codeBase "www.horstmann.com/classes/"{... }; 
grant codeBase "www.horstmann.com/classes/MyApp.jar" {.. . }; 


代码 基 是 一 个 URL 并 且 总 是 以 斜 杠 作为 文件 分 隔 符 ， 即 使 是 Windows 中 的 文件 URL, 
也 是 如 此 。 例如 


grant codeBase "file:C:/myapps/classes/"{... }; 


注意 : 大 家 都 知道 http 格式 的 URL Hr MH de (nttp://) 开头 的 ， 但 是 它 很 容易 
与 file 格式 的 URL 搞 混 淆 ， 策 略 文件 阅读 器 接受 两 种 格式 的 file URL， 即 file:// 
localFile fe file:localFile, «9+, Windows 驱动 器 名 前 面 的 斜 杠 是 可 有 可 无 的 。 也 就 
是 说 ， 下 面 的 各 种 表示 都 是 可 以 接受 的 : 
file:C:/dir/filename, ext 
File:/C:/dir/filename. ext 


file://C:/dir/filename.ext 
file:///C:/dir/filename.ext 


实际 上 上， 我们 的 测试 结果 是 File:////C:/dir/filename.ext 也 是 允许 的 ， 对 此 我 们 
权限 采用 下 面 的 结构 : 


permission className targetName, actionList; 


类 名 是 权限 类 的 全 称 类 名 (比如 java.io.FilePermission)。 目 标 名 是 个 与 权限 相关 的 
值 ， 例 如 ， 文 件 权 限 中 的 目录 名 或 者 文件 名 ， 或 者 是 socket 权限 中 的 主机 和 端口 。 操 作 列表 
同样 是 与 权限 相关 的 ， 它 是 一 个 操作 方式 的 列表 ， 比 如 read 或 者 connect 等 操作 ， 用 逗号 
分 隅 。 有 些 权 限 类 并 不 需要 目标 名 和 操作 列表 。 表 9-2 列 出 了 标准 的 权限 和 它们 执行 的 操作 。 


表 9-2 权限 及 其 相关 的 目标 和 操作 
到 at 


java.io.FilePermission 文件 目标 ( 见 正文 ) read, write, execute, delete 
java.net.SocketPermission Socket HR ( 见 正 文 ) accept, connect, listen, resolve 
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权 限 E 标 操 作 


java.util.PropertyPermission | 属性 目标 ( 见 正文 ) read, write 


java.lang.RuntimePermission 


java.awt.AWTPermission 


java.net .NetPermission 


createClassLoader 





getClassLoader 





setContextClassLoader 






enableContextClassLoaderOverride 






createSecurityManager 






setSecurityManager 
exitVM 


getenv.variableName 






shutdownHooks 





setFactory 
setI0O 
modifyThread 







stopThread 






modifyThreadGroup 







getProtectionDomain 






readFileDescriptor 






writeFileDescriptor 






loadLibrary.libraryName 


accessClassInPackage.packageName 






defineClassInPackage.packageName 






accessDeclaredMembers .className 






queuePrintJob 





getStackTrace 
setDefaul tUncaughtExcepti onHandler 






preferences 






usePolicy 






showWindowWithoutWarningBanner 


accessClipboard 






accessEventQueue 







createRobot 





fullScreenExclusive 
listenToAl1lAWTEvents 
readDisplayPixels 






replaceKeyboardF ocusManager 






watchMousePointer 






setWindowAlwaysOnTop 
setAppletStub 
setDefaultAuthenticator 
specifyStreamHandler 







requestPasswordAuthentication 


(无 ) 


(无 ) 


(无 ) 
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权 R 


java.net.NetPermission 


java. lang.reflect.ReflectPermission 


A ÈR 
setProxySelector (7) 


getProxySelector 


setCookieHandler 
getCookieHandler 


setResponseCache 





getResponseCache 


suppressAccessChecks (E) 


java.io.SerializablePermission j|enableSubclassImplementation (3c) 
enableSubstitution 


java. security.SecurityPermission 


java.security.Al1lPermission 





createAccessControlContext (无 ) 
getDomainCombiner 

getPolicy 

setPolicy 

getProperty.keyName 
setProperty.keyName 
insertProvider . providerName 
removeProvider . providerName 
setSystemScope 

setIdentityPub1 icKey 
setIdentityInfo 
addIdentityCertificate 
removeldentityCertificate 
printIdentity 
clearProviderProperties . providerName 
putProviderProperty . providerName 
removeProviderProperty . providerName 
getSignerPrivateKey 
setSignerKeyPair 


(无 ) (无 ) 


javax.security.auth.AuthPermission 





doAs (无 ) 
doAsPrivileged 

getSubject 
getSubjectFromDomainCombiner 
setReadOnly 

modifyPrincipals 
modifyPublicCredentials 
modifyPrivateCredentials 
refreshCredential 
destroyCredential 
createLoginContext.contextName 





(  ) 


权 R A $ 操 作 
(无 ) 






javax.security.auth.AuthPermission |getLoginConfiguration 
setLoginConfiguration 


refreshLoginConfiguration 


Ja an oaa oaen oro OOOO S 


正如 表 9-2 中 所 示 ， 大 部 分 权限 只 允许 执行 某 种 特定 的 行为 。 可 以 将 这 些 行为 视 为 带 有 一 
个 隐 含 操作 “permit” 的 目标 。 这 些 权 限 类 都 继承 自 BasicPermission 类 (参见 本 章 图 9-7 )。 
然而 ， 文 件 、socket 和 属性 权限 的 目标 都 比较 复杂 ， 我 们 必须 对 它们 进行 详细 介绍 。 

文件 权限 的 目标 可 以 有 下 面 几 种 形式 : 


file 文件 

directory/ 目录 

directory/* 目录 中 的 所 有 文件 

当前 目录 中 的 所 有 文件 
directory/— 目录 和 其 子 目 录 中 的 所 有 文件 

- 当然 目录 和 其 子 目 录 中 所 有 文件 
<<ALL FILES>> 文件 系统 中 的 所 有 文件 


例如 ， 下 面 的 权限 项 赋予 对 /myapp 目录 和 它 的 子 目 录 中 的 所 有 文件 的 访问 权限 。 


permission java.io.FilePermission "/myapp/-", 


Wr Zi (SE FA \\ 转 义 字符 序列 来 表示 Window 文件 名 中 的 反 斜 杠 。 


permission java.io.FilePermission "c:\\myapp\\-", 


Socket 权限 的 目标 由 主机 和 端口 范围 组 成 。 对 主机 的 描述 具有 下 面 几 种 形式 : 


read write, delete"; 


read write, delete"; 


hostname BY IPaddress 单个 主机 

localhost 或 空 字符 串 本 地 主机 

*.domainSuf fix 以 给 定 后 缀 结尾 的 域 中 所 有 的 主机 
* 所 有 主机 

端口 范围 是 可 选 的 ， 具 有 下 面 几 种 形式 : 

:n 单个 端口 

: n 一 编号 大 于 等 于 n 的 所 有 端口 

:一 站 编号 小 于 等 于 n 的 所 有 端口 


:nl-n2 “位 于 给 定 范围 内 的 所 有 端口 
下 面 是 一 个 权限 的 实例 : 


permission java.net.SocketPermission "*.horstmann.com:8000-8999", "connect"; 


最 后 ， 属 性 权限 的 目标 可 以 采用 下 面 两 种 形式 之 一 : 





424 Java ZSRR Al BAHH 


property 一 个 具体 的 属性 
propertyPrefix.* 带 有 给 定 前 级 的 所 有 属性 


“java.home” 和 “java.vm.*” 就 是 这 样 的 例子 。 
例如 ， 下 面 的 权限 项 允许 程序 读 取 以 java. vm 开头 的 所 有 属性 。 


permission java.util.PropertyPermission "java.vm.*", "read"; 


可 以 在 策略 文件 中 使 用 系统 属性 ， 其 中 的 ${property} 标记 会 被 属性 值 蔡 代 ， 例 如 ， 
${user .home} 会 被 用 户主 目录 替代 。 下 面 是 在 访问 权限 项 中 使 用 系统 属性 的 典型 应 用 。 


permission java.io.FilePermission "${user.home}", "read,write"; 


为 了 创建 平台 无 关 的 策略 文件 ， 使 用 file.separator 属性 而 不 是 使 用 显 式 的 /或 
者 \ 分 阳 符 绝对 是 个 好 主意 。 如 果 要 使 它 更 加 简单 ， 可 以 使 用 符号 ${/} 作 为 ${file. 
separator} 的 缩写 。 例 如 ， 

permission java.io.FilePermission "${user.home}${/}-", "read,write”; 

是 一 个 可 在 平台 之 间 移 植 的 项 ， 用 于 授予 对 在 用 户 的 主 目录 及 其 子 目 录 中 的 文件 进行 读 
写 的 权限 。 


注意 : IDK 提供 了 一 个 名 为 policytoo1 的 基础 工具 ， 可 以 用 它 编辑 策略 文件 (参见 图 
9-8 )。 当 然 ， 该 工具 对 完全 不 清楚 其 大 部 分 设置 的 用 户 来 说 是 不 适用 的 。 这 正好 证 明了 
这 样 一 种 观念 ， 管 理工 具 可 能 只 能 供 那 些 关心 “定位 -点击 操 作 ”， 而 不 关心 具体 语法 的 
系统 管理 员 使 用 。 尽 管 如 此 ， 它 所 欠缺 的 是 对 于 非 专家 用 户 来 说 非常 具有 实际 意义 的 级 
别 设置 《例如 低 ， 中 或 者 高 安全 性 设置 )。 一 般 来 说 ， 我 们 相信 Java 2 平台 肯定 包含 了 所 
有 级 别 的 细 粒 度 安 全 模型 ， 但 是 将 这 些 模型 提供 给 最 终 用 户 和 系统 管理 员 会 获得 更 大 的 
收益 。 


9.2.4 定制 权限 


在 本 节 中 ， 我 们 将 要 介绍 如 何 把 自己 的 权限 类 提供 给 用 户 ， 以 使 得 他 们 可 以 在 策略 文件 
中 引用 这 些 权 限 类 。 
如 果 要 实现 目 己 的 权限 类 ， 可 以 继承 Permission 类 ， 并 提供 以 下 方法 : 
e 市 有 两 个 String 参数 的 构造 器 ， 这 两 个 参数 分 别 是 目标 和 操作 列表 
e String getActions() 
e boolean equals(Object other) 
e int hashCode() 
e boolean implies(Permission other) 
最 后 一 个 方法 是 最 重要 的 。 权 限 有 一 个 排序 ， 其 中 更 加 泛 化 的 权限 隐 含 了 更 加 具体 的 权 
请 考虑 下 面 的 文件 权限 : 


pl = new FilePermission("/tmp/-", "read, write”); 


限 


(s) 
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图 9-8 ”策略 工具 


该 权限 允许 读 写 /tmp 目录 以 及 子 目 录 中 的 任何 文件 。 
该 权限 隐 含 了 其 他 更 加 具体 的 权限 : 


p2 = new FilePermission("/tmp/-", "read"); 
p3 = new FilePermission("/tmp/aFile", "read, write”); 
p4 = new FilePermission("/tmp/aDirectory/-", Write ); 


换 句 话说 ， 如 果 

o pl 的 目标 文件 集 包含 p2 的 目标 文件 集 。 

o pl 的 操作 集 包含 p2 的 操作 集 。 

MA, 文件 访问 权限 pl 就 隐 含 了 另 一 个 文件 访问 权限 p2。 

请 考虑 下 面 关于 implies 方法 的 用 法 举例 。 当 FileInputStream 构造 右 想 要 打开 一 个 
文件 ， 以 读 取 该 文件 时 ， 要 检查 它 是 否 拥有 操作 权限 。 如 果 要 执行 这 种 检查 ， 就 应 将 一 个 具 
体 的 文件 权限 对 象 传递 给 checkPermission 方法 : 

checkPermission(new FilePermission(fileName, "read")); 

现在 安全 管理 器 询问 所 有 适用 的 权限 是 否 隐 含 了 该 权限 。 如 果 其 中 有 茶 个 隐 含 了 该 权限 ， 
就 通过 了 检查 。 

特别 地 ，A11Permission 隐 含 了 其 他 所 有 的 权限 。 

如 果 你 定义 了 自己 的 权限 类 ， 那 么 必须 对 权限 对 象 定义 一 个 合适 的 隐 仿 法则。 例如， 假 
设 你 为 采用 Java 技术 的 机 顶 盒 定义 一 个 TVPermission， 那 么 下 面 这 个 访问 权限 

new TVPermission("Tommy:2-12:1900-2200", "watch, record") 

将 允许 Tommy 在 19 点 到 22 点 之 间 对 2 至 12 频道 的 电视 节目 进行 观看 和 录像 。 必 须 实 
现 implies 方法 ， 以 隐 含 像 下面 这 样 的 更 具体 的 权限 。 

new TVPermission("Tommy:4:2000-2100", "watch") 





426 Java ZSRR A ZRH 


9.2.5 “实现 权限 类 


在 下 面 这 个 示例 程序 中 ， 我 们 实现 了 一 个 新 的 权限 ， 用 于 监视 将 文本 插入 到 文本 域 的 操 
作 。 该 程序 会 确保 你 不 能 输入 “不 良 单词 ”， 例 如 sex, drugs 以 及 C++ 等 。 我 们 使 用 了 一 
个 定制 的 权限 类 ， 以 便 在 策略 文件 中 提供 这 些 不 良 单词 。 

下 面 这 个 JTextArea 的 子 类 询问 安全 管理 器 是 否 准备 好 了 去 添加 新 文本 。 


class WordCheckTextArea extends JTextArea 
public void append(String text) 
{ 


WordCheckPermission p = new WordCheckPermission(text, "insert"); 
SecurityManager manager = System.getSecurityManager() ; 
if (manager != null) manager.checkPermission(p); 
Super. append(text) ; 
} 
} 


如 果 安 全 管理 器 赋予 了 WordCheckPermission 权限 ， 那 么 该 文本 就 可 以 追加 。 和 否则 ， 
checkPermission 方法 就 会 抛 出 一 个 异常 。 

单词 检查 权限 有 两 个 可 能 的 操作 ， 一 个 是 insert (用 于 插入 具体 文本 的 权限 )， 另 一 个 是 
avoid (添加 不 包含 某 些 不 良 单 词 的 任何 文本 的 权限 )。 应 该 用 下 面 的 策略 文件 运行 这 个 程序 : 


grant 


permission permissions.WordCheckPermission "sex,drugs,(++", "avoid"; 


这 个 策略 文件 赋予 的 权限 是 可 以 插入 不 包含 不 良 单词 sex, drugs 和 C++ 的 任何 文本 。 
当 设 计 WordCheckPermission 类 时 ， 我 们 必须 特别 注意 implies 方法 ， 下 面 是 控制 
权限 pl 是 否 隐 含 p2 的 规则 : 
e 如 采 pl A avoid 操作 ，p2 有 insert 操作 ， ABA p2 的 目标 必须 避 开 pl 中 的 所 有 单 
词 。 例 如 ， 下 面 这 个 权限 : 
permissions.WordCheckPermission "sex,drugs,C++", "avoid" 
隐 含 了 下 面 这 个 权限 : 
permissions.WordCheckPermission "Mary had a little lamb", "insert" 
o 如 采 pl A p2 AA avoid RE, 那么 p2 的 单词 集合 必须 包含 pl 单词 集合 中 的 所 有 单 
词 。 例 如 ， 下 面 这 个 权限 : 
permissions.WordCheckPermission “sex,drugs", "avoid" 
隐 含 了 下 面 这 个 权限 : 
permissions.WordCheckPermission "sex,drugs,C++", "avoid" 
o 如 果 pl Al p2 都 有 insert 操作 ， 那 么 pl 的 文本 必须 包含 p2 的 文本 。 例 如 ， 下 面 这 
个 权限 : 
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permissions.WordCheckPermission "Mary had a little lamb", "insert" 


包含 了 下 面 这 个 权限 : 


permissions.WordCheckPermission "a little lamb", "insert" 


可 以 在 程序 清单 9-4 中 看 到 该 类 的 具体 实现 。 

请 注意 ， 可 以 用 Permission 类 中 名 字 容 易 混 淆 的 getName 方法 来 获取 权限 的 目标 。 

由 于 在 策略 文件 中 权限 是 由 一 对 字符 串 来 表示 的 ， 因 此 ， 权 限 类 需要 准备 好 解析 这 些 字 
符 串 。 特 别 地 ， 我 们 应 该 使 用 下 面 的 方法 ， 将 用 逗号 分 隔 的 avoid 权限 的 不 良 单词 表 转 换 为 
一 个 真正 的 Set。 

public Set<String> badWordSet() 

Set<String> set = new HashSet<String>() ; 
set.addAl] (Arrays.asList(getName().split(","))); 


return set; 


} 

该 代码 允许 我 们 用 equals 和 containsAl] 方法 来 比较 这 些 集 。 正 如 我 们 在 第 3 章 中 
所 介绍 的 那样 ， 如 果 两 个 集 包 含 任意 次 序 的 相同 元 素 ， 那 么 集 类 的 equals 方法 可 以 判定 它 
们 相等 。 例如， 由 “sex,drugs,C++” 和 “C++,drugs ,sex” 产 生 的 两 个 集 是 相等 的 集 。 


O 警告 : 务必 要 把 你 的 权限 类 设 为 pub1ic。 策 略 文件 加 载 器 不 能 加 载 包 可 视 性 超出 引导 
类 路 径 之 外 的 类 ， 并 且 它 会 悄悄 忽略 其 无 法 找到 的 所 有 类 。 


程序 清单 9-5 中 的 程序 展示 了 WordCheck Permission 类 是 如 何 工 作 的 。 请 在 文本 框 
内 输入 任意 文本 ， 然 后 按 下 Insert 按钮 。 如 果 文 本 通过 了 安全 检查 ， 该 文本 就 会 被 添加 到 
文本 区 域 中 。 如 果 没 有 通过 检查 ， 就 会 弹出 一 个 消息 (参见 图 9-9 ) 。 





图 9-9 Permission Test ar 


O GH: 如 果 仔 细 看 看 图 9-9， 就 会 看 到 消息 窗口 带 有 一 个 警告 三 角形 ， 这 是 用 来 警告 用 户 
HR OTRARALBARAARGMLE. RERERNA DRE RELI 
签 ， 即 “未 受信 的 Java Applet 窗口 " ， 在 后 续 JDK 的 多 个 连续 版 本 中 ， 其 因 惯 性 而 一 直 
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保留 了 下 来 。 现 在 ， 它 对 警告 用 户 来 说 已 经 变 得 毫 无 意义 了 。 这 个 警告 可 以 通过 java. 

awt.AWT Permission 的 showWindowWithout-WarningBanner 目标 来 关闭 。 如 果 你 

喜欢 ， 可 用 编辑 策略 文件 以 赋予 该 权限 。 

你 现在 已 经 看 到 应 该 如 何 配置 Java 平台 的 安全 性 了 。 更 常见 的 情况 是 ， 你 只 需 微调 标准 
的 权限 集 。 对 于 其 他 额外 的 控制 ， 你 可 以 定义 自制 的 权限 ， 它 们 应 该 可 以 按照 与 标准 权限 相 





1 
2 
3 
4 
5 
6 
7 


同 的 方式 配置 。 






package permissions; 


import java.security.*; 
import java.util.*; 


/** 
* A permission that checks for bad words. 
gi 
public class WordCheckPermission extends Permission 


{ 


private String action; 


/** 
* Constructs a word check permission. 
* @param target a comma separated word list 
* @param anAction "insert" or "avoid" 
"| 
public WordCheckPermission(String target, String anAction) 


Super(target) ; 
action = anAction; 


} 
public String getActions() 
{ 


return action; 


} 


public boolean equals(Object other) 
{ 
if (other == null) return false; 
if (!getClass().equals(other.getClass())) return false: 
WordCheckPermission b = (WordCheckPermission) other; 
if (!0bjects.equals(action, b.action)) return false: 
if (“insert".equals(action)) return Objects.equals(getName(), b.getName()); 
else if ("avoid".equals(action)) return badWordSet().equals(b.badWordSet()); 
else return false; 


} 


public int hashCode () 
{ 


return Objects.hash(getName(), action); 





} 


} 


public boolean implies(Permission other) 


{ 
if (!(other instanceof WordCheckPermission)) return false; 
WordCheckPermission b = (WordCheckPermission) other; 
if (action.equals("insert")) 


return b.action.equals("insert") && getName().index0f(b.getName()) >= 0; 
} 


else if (action.equals("avoid")) 


if (b.action.equals("avoid")) return b.badWordSet() .containsAl] (badWordSet()) ; 
else if (b.action.equals("insert")) 


{ 
for (String badWord : badWordSet()) 
if (b.getName().index0f(badWord) >= 0) return false; 
return true; 


else return false; 


else return false: 


/** 


* Gets the bad words that this permission rule describes. 
* @return a set of the bad words 
*/ 
public Set<String> badWordSet() 
{ 
Set<String> set = new HashSet<>(); 
set. addAl] (Arrays.asList(getName().split(","))); 
return set; 
} 


package permissions; 


import java.awt.*: 


import javax.swing.*; 


/** 


* This class demonstrates the custom WordCheckPermission. 


* 


@version 1.04 2016-05-10 


* @author Cay Horstmann 


了 


public class PermissionTest 


{ 


public static void main(String[] args) 


{ 
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16 System. setProperty("java.security.policy", "permissions/PermissionTest. policy"); 
17 System. setSecurityManager(new SecurityManager()); 

18 EventQueue.invokeLater(() -> 

19 

20 JFrame frame = new PermissionTestFrame(); 

21 frame.setTitle("PermissionTest"); 

22 frame. setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE); 
23 frame. setVisible(true) ; 

24 i 

25 } 

26 } 

27 

28 /** 


29 * This frame contains a text field for inserting words into a text area that is protected from 
30 * "bad words". 

31 */ 

32 class PermissionTestFrame extends JFrame 

3 { 

34 private JTextField textField; 

35 private WordCheckTextArea textArea; 

36 private static final int TEXT_ROWS = 20; 

37 private static final int TEXT_COLUMNS = 60; 


39 public PermissionTestFrame() 


40 { 

41 textField = new JTextField(20); 

42 JPanel panel = new JPanel(); 

43 panel .add(textField); 

44 JButton openButton = new JButton("Insert"); 

45 panel .add(openButton) ; 

46 openButton.addActionListener(event -> insertWords(textField.getText())); 
47 

48 add(panel, BorderLayout ,NORTH) ; 

49 

50 textArea = new WordCheckTextArea() ; 

51 textArea, setRows (TEXT_ROWS) ; 

52 textArea.setColumns (TEXT_COLUMNS) ; 

53 add(new JScrol]Pane(textArea), BorderLayout. CENTER) ; 

54 pack(); 

55 } 

56 

57 /** 

58 * Tries to insert words into the text area. Displays a dialog if the attempt fails. 
59 * @param words the words to insert 

60 */ 

61 public void insertWords(String words) 

62 { 

63 try 

64 { 

65 textArea.append(words + "\n"); 

66 

67 catch (SecurityException ex) 

68 

69 JOptionPane.showMessageDialog(this, "I am sorry, but I cannot do that."); 
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70 ex.printStackTrace() ; 


11 } 


75 /** 

75 * A text area whose append method makes a security check to see that no bad words are added. 
7 */ 

78 Class WordCheckTextArea extends JTextArea 


80 public void append(String text) 


82 WordCheckPermission p = new WordCheckPermission(text, "“insert"); 
83 SecurityManager manager = System.getSecurityManager () ; 

84 if (manager != null) manager.checkPermission(p) ; 

85 Super. append(text) ; 





e Permission(String name) 
用 指定 的 目标 名 构建 一 个 权限 。 
e String getName( ) 
返回 该 权限 的 对 象 名 称 。 
eboolean implies(Permission other ) 
检查 该 权限 是 否 隐 含 了 other 权限 。 如 果 other 权限 描述 了 一 个 更 加 具体 的 条 件 ， 而 这 个 
具体 条 件 是 由 该 权限 所 描述 的 条 件 所 产生 的 结果 ， 那 么 该 权限 就 隐 含 这 个 other 权限 。 


93 用户 认证 


Java API 提供 了 一 个 名 为 Java 认证 和 授权 服务 的 框架 ， 它 将 平台 提供 的 认证 与 权限 管理 
集成 起 来 。 我 们 将 在 以 下 各 节 中 讨论 JAAS FEZ 


9.3.1 JAAS 框架 


正如 其 名 字 所 表示 的 ，Java 认证 和 授权 服务 (JAAS, Java Authentication and Authorization 
Service) 包含 两 部 分 :“ 认 证 ”部 分 主要 负责 确定 程序 使 用 者 的 身份 ， 而 “授权 ”将 各 个 用 户 
映射 到 相应 的 权限 。 

JAAS 是 一 个 可 插 拔 的 API， 可 以 将 Java 应 用 程序 与 实现 认证 的 特定 技术 分 离开 来 。 除 
此 之 外 ，JAAS 还 支持 UNIX 登录 、NT BH, Kerberos 认证 和 基于 证 书 的 认证 。 

一 旦 用 户 通过 认证 ， 就 可 以 为 其 附加 一 组 权限 。 例 如 ， 这 里 我 们 赋予 Harry 一 个 特定 的 
权限 集 ， 而 其 他 用 户 则 没有 ， 它 的 语法 规则 如 下 : 
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grant principal com.sun.security.auth.UnixPrincipal "harry" 
permission java.util.PropertyPermission “user.*", "read"; 


} 


在 该 语法 中 ，com. sun.security.auth.UnixPrincipal 类 检查 运行 该 程序 的 UNIX 
APA, ER getName 方法 将 返回 UNIX 登录 名 ， 然 后 我 们 就 可 以 检查 该 名 称 是 否 等 
F “harry”. 

可 以 使 用 一 个 LoginContext 以 使 得 安全 管理 器 能 够 检查 这 样 的 授权 语句 。 下 面 是 登录 
代码 的 基本 轮廓 : 


try 
{ 
System. setSecuri tyManager(new SecurityManager()); 
LoginContext context = new LoginContext("Login1"); // defined in JAAS configuration file 
context. login(); 
// get the authenticated Subject 
Subject subject = context. getSubject(); 


context. logout(); 
} 


catch (LoginException exception) // thrown if login was not successful 


exception. printStackTrace() ; 


这 里 ，subject 是 指 已 经 被 认证 的 个 体 。 
LoginContext 构造 右 中 的 字符 串 参数 “Login1” 是 指 JAAS 配置 文件 中 具有 相同 名 字 
的 项 。 下 面 是 一 个 简单 的 配置 文件 : 


Loginl 
{ 
com. sun. security.auth,.module. UnixLoginModule required: 
com.whizzbang. auth.module.RetinaScanModule sufficient: 
}; 
Login2 
{ 


} 


当然 ，JDK 中 没有 包含 任何 使 用 biometric 的 登录 模块 。JDK 在 com. sun. security. 
auth. module 包 中 包含 以 下 模块 . 


UnixLoginModule 
NTLoginModule 
Krb5LoginModule 
JndiLoginModule 
KeyStoreLoginModule 


一 个 登录 策略 由 一 个 登录 模块 序列 组 成 ， 每 个 模块 被 标记 为 required, sufficient, 
requisite 或 optional。 这 些 关键 字 的 含义 在 下 面 的 算法 中 进行 了 描述 . 





1) 各 个 模块 依次 执行 ， 直 到 有 一 个 sufficient 的 模块 认证 成 功 ， 或 者 有 一 个 
requisite 的 模块 认证 失败 ， 或 者 已 经 执行 到 最 后 一 个 模块 时 才 停 止 。 

2) 当 标 记 为 required 和 requisite 的 所 有 模块 都 认证 成 功 ， 或 者 它们 都 没有 被 执 
行 ， 但 至 少 有 一 个 sufficient 或 optional 的 模块 认证 成 功 时 ， 这 次 认证 就 成 功 了 。 

登录 时 要 对 登录 的 主体 (subject) 进行 认证 ， 该 主体 可 以 拥有 多 个 特征 ( principal)。 特 
征 描述 了 主体 的 某 些 属性 ， 比 如 用 户 名 、 组 ID 或 角色 等 。 我 们 在 grant 语句 中 可 以 看 
到 ， 特 征管 制 着 各 个 权限 。com.sun.security.auth.UnixPrincipal 类 描述 了 UNIX 登录 名 ， 
UnixNumericGroupPrincipal 类 可 以 用 来 检测 用 户 是 否 归属 于 某 个 UNIX HPH. 

使 用 下 面 的 语法 ，grant 语句 可 以 对 一 个 特征 进行 测试 : 


grant principalClass "principalName” 


例如 : 

grant com.sun.security.auth.UnixPrincipal “harry” | 

当 用 户 登 录 后 ， 就 会 在 独立 的 访问 控制 上 下 文中 ， 运 行 要 求 检查 用 户 特 征 的 代码 。 使 用 
静态 的 doAs 或 doAsPrivileged 方 法 ， 启动 一 个 新 的 PrivilegedAction,， 其 run 方法 
就 会 执行 这 段 代 码 。 

这 两 个 方法 都 可 以 通过 使 用 主体 特征 的 权限 来 调用 某 个 对 象 的 run 方法 去 执行 特定 操 
作 ， 而 该 对 象 必须 是 实现 了 PrivilegedAction 接口 的 对 象 。 


PrivilegedAction<T> action = () -> 


// run with permissions of subject principals 


}; 
T result = Subject.doAs(subject, action); // or Subject.doAsPrivileged(subject, action, null) 


如 果 该 操作 会 抛 出 受 检 查 的 异常 ， 那 么 必须 改 为 实现 PrivilegedExceptionAction 
接口 。 

doAs 和 doAsPrivileged 方法 之 间 的 区 别 是 微小 的 。doAs 方法 开始 于 当前 的 访问 控制 
EFX, 而 doAsPrivileged 方法 则 开始 于 一 个 新 的 上 下 文 。 后 者 允许 将 登录 代码 和 “业务 
逻辑 ”的 权限 相 分 离 。 在 我 们 的 示例 应 用 程序 中 ， 登 录 代码 有 如 下 权限 : 


permission javax.security.auth.AuthPermission "createLoginContext.Loginl"; 
permission javax.security.auth.AuthPermission "doAsPrivileged" ; 


通过 认证 的 用 户 有 一 个 权限 : 

permission java.util.PropertyPermission "user.*", "read"; 

如 果 我 们 用 doAs 代替 了 doAsPrivileged,， 那么 登录 代码 也 需要 这 个 权限 ! 

程序 清单 9-6 和 程序 清单 9-7 的 程序 展示 了 如 何 限制 某 些 用 户 的 权限 。AuthTest 程序 对 
用 户 的 身份 进行 了 认证 ， 然 后 运行 了 一 个 简单 的 操作 ， 以 获得 一 个 系统 属性 。 

要 使 该 例子 能 够 运行 ， 必 须 将 登录 类 和 操作 类 的 代码 封装 到 两 个 独立 的 JAR 文件 中 : 
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javac auth/*.java 
jar cvf login.jar auth/AuthTest.class 
jar cvf action.jar auth/SysPropAction.class 


如 有 果 查 看 程序 清单 9-8 中 的 策略 文件 ， 将 会 看 到 名 为 harry 的 UNIX 用 户 拥 有 读 取 所 有 
文件 的 权限 。 将 harry 改 为 你 自己 的 登录 名 ， 然 后 运行 下 面 的 命令 


java -classpath 10gin,jar:action,jar 
-Djava. security. policy=auth/AuthTest. policy 
-Djava. security. auth. login. config=auth/jaas. config 
auth. AuthTest 


程序 清单 9-9 展示 了 登录 的 配置 。 
在 Windows 下 运行 时 ， 请 将 AuthTest.policy 中 的 UnixPrincipal 改 为 NTUser-- 
Principal， 并 将 jaas.config PAY UnixLoginModule 改 为 NTLoginModu1le。 运 行 该 程 


序 时 ， 请 用 分 号 来 分 隔 各 个 JAR 文件 : 

java -classpath login.jar;action.jar ，，， 

AuthTest 程序 现在 将 显示 user .home 属性 的 值 。 但 是 ， 如 果 用 不 同 的 名 字 登 录 ， 那 么 
就 应 该 抛 出 一 个 安全 异常 ， 因 为 你 不 再 拥有 必需 的 权限 了 。 


O 警告 : 必须 严格 按照 这 些 指令 来 运行 。 如 果 对 程序 进行 了 一 些 看 上 去 无 关 紧要 的 更 改 ， 
那 就 很 容易 使 你 的 设置 出 错 。 





package auth; 


import java.security.*; 
import javax.security.auth.*; 
import javax.security.auth. login. *; 


/** 
* This program authenticates a user via a custom login and then executes the SysPropAction with 
* the user's privileges, 

10 * @version 1.01 2007-10-06 

11 * @author Cay Horstmann 

2 */ 

13 public class AuthTest 


WO oo N an n Aa w N j 


15 public static void main(final String[] args) 


16 { 

17 System. setSecurityManager(new SecurityManager()); 

18 try 

19 { 

20 LoginContext context = new LoginContext("Login1"); 

21 context. login(); 

22 System.out.printIn("Authentication successful."): 

23 Subject subject = context. getSubject(); 

24 System.out.printin("subject=" + subject); 

25 PrivilegedAction<String> action = new SysPropAction("user. home"); 
26 String result = Subject.doAsPrivileged(subject, action, null): 
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27 System.out.printIn(result) ; 
28 context. logout (); 

29 

30 catch (LoginException e) 

31 { 

32 e.printStackTrace() ; 

33 } 

34 } 

35 } 





package auth; 


import java.security.*; 


This action looks up a system property. 
* @version 1.01 2007-10-06 


* @author Cay Horstmann 


1 
2 
3 
4 
s /** 
6 
7 
8 
9 * 


10 public class SysPropAction implements PrivilegedAction<String> 


12 private String propertyName; 


14 /** 

15 Constructs an action for looking up a given property, 

16 @param propertyName the property name (such as “user.home") 
7 */ 


18 public SysPropAction(String propertyName) { this.propertyName = propertyName; } 


20 public String run() 


21 { 
22 return System.getProperty(propertyName) ; 





1 grant codebase "file: login.jar" 


{ 


permission javax.security.auth.AuthPermission "createLoginContext.Login1"; 
permission javax.security.auth.AuthPermission "doAsPrivileged"; 


}; 


2 
3 
4 
5 
6 
7 grant principal com.sun.security.auth.UnixPrincipal "harry" 
8 

9 


permission java.uti].PropertyPermission “user.*", "read": 


10 o}; 





1 Loginl 
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2 { 
3 com. Sun.security.auth.module.UnixLoginModule required; 


4 5; 





e LoginContext(String name) 
创建 一 个 登录 上 下 文 。name 对 应 于 JAAS 配置 文件 中 的 登录 描述 符 。 
e void login() 
建立 一 个 登录 操作 ， 如 果 登 录 失 败 ， 则 抛 出 一 个 LoginException 异常 。 它 会 调用 
JAAS 配置 文件 中 的 管理 器 上 的 login 方法 。 
evoid logout() 
Subject 退出 登录 。 它 会 调用 JAAS 配置 文件 中 的 管理 器 上 的 logout 方法 。 
e Subject getSubject() 
返回 认证 过 的 Subject, 





èe Set<Principal> getPrincipals() 


获取 该 Subject 的 各 个 Principal。 
e static Object doAs(Subject subject, PrivilegedAction action) 


estatic Object doAs(Subject subject, PrivilegedExceptionAction 
action) 

estatic Object doAsPrivileged(Subject subject, PrivilegedAction 
action, AccessControlContext context) 

estatic Object doAsPrivileged(Subject subject, 
PrivilegedExceptionAction action, AccessControlContext context) 
以 subject 的 身份 执行 特许 操作 。 它 将 返回 run 方法 的 返回 值 。doAsPrivileged 
方法 在 给 定 的 访问 控制 上 下 文中 执行 该 操作 ， 你 可 以 提供 一 个 在 前 面 调用 静态 方法 
AccessController.getContext() 时 所 获得 的 “上 下 文 快 照 *， 或 者 指定 为 nu11， 

以 便 使 其 在 一 个 新 的 上 下 文中 执行 该 代码 。 





e Object run() 
必须 定义 该 方法 ， 以 执行 你 想 要 代表 某 个 主体 去 执行 的 代码 。 








e Object run() 
必须 定义 该 方法 ， 以 执行 你 想 要 代表 某 个 主体 去 执行 的 代码 。 本 方法 可 以 抛 出 任何 受 








返回 该 特征 的 身份 标识 。 


9.3.2 JAAS 登录 模块 


在 本 节 中 ， 我 们 将 要 用 一 个 JAAS 例子 向 读者 介绍 : 

e 如 何 实 现 你 自己 的 登录 模块 ; 

o 如 何 实现 基于 角色 的 认证 。 

如 果 登 录 信 息 存储 在 数据 库 中 ， 那 么 使 用 自己 的 登录 模块 就 非常 有 用 。 尽 管 你 可 能 很 喜欢 
默认 的 登录 模块 ， 但 是 学 习 如 何 定制 自己 的 模块 将 有 助 于 你 理解 JAAS 配置 文件 的 各 个 选项 。 

基于 角色 的 认证 对 于 大 量 用 户 的 管理 来 说 是 十 分 必要 的 。 将 所 有 合法 用 户 的 名 字 都 写 人 
策略 文件 是 不 切实 际 的 。 而 登录 模块 应 该 将 用 户 映射 到 诸如 “admin” 或 “HR” 等 和 角色， 并 
且 权 限 的 赋予 也 要 基于 这 些 角 色 。 

登录 模块 的 工作 之 一 是 组 装 被 认证 的 主体 的 特征 集 。 如 果 一 个 登录 模块 支持 某 些 角色 ， 
该 模块 就 会 添加 Principal 对 象 来 描述 这 些 角色 。JDK 并 没有 提供 相应 的 类 ， 所 以 我 们 写 了 
自己 的 类 ( 见 程序 清单 9-10 )。 该 类 直接 存储 了 一 个 描述 / 值 对 ， 例 如 role=admin。 该 类 的 
getName 方法 用 于 返回 该 描述 / 值 对 ， 因 此 我 们 就 可 以 添加 基于 角色 的 权限 到 策略 文件 中 : 


grant principal SimplePrincipal "role=admin" { ，，，} 


我 们 的 登录 模块 会 在 包含 如 下 行 的 文本 文件 中 查找 用 户 、 密 码 和 角色 : 


harry|secret|admin 
carl |guessme|HR 


当然 ， 在 实际 的 登录 模块 中 ， 你 可 能 会 将 这 些 信 息 存 储 在 数据 库 或 者 目录 中 。 

在 程序 清单 9-11 中 可 以 找到 SimpleLoginModule 的 代码 ， 其 checkLogin 方法 用 于 
检查 输入 的 用 户 名 和 密码 是 否 与 密码 文件 中 的 用 户 记 录 相 匹配 。 如 果 匹 配 成 功 ， 则 会 添加 两 
个 SimplePrincipal 对 象 到 主体 的 特征 集中 。 


Set<Principal> principals = subject.getPrincipals(); 
principals.add(new SimplePrincipal ("username", username)) ; 
principals.add(new SimplePrincipal("role", role)); 


SimpleLoginModule 剩余 的 部 分 就 非常 直截了当 了 。initialize 方法 接收 下 面 几 个 参数 : 
e 用 于 认证 的 Subject。 

e 一 个 获取 登录 信息 的 handler。 

e 一 个 sharedState 映射 表 ， 它 可 以 用 于 登录 模块 之 间 的 通信 。 

e 一 个 options 映射 表 ， 它 包含 了 登录 配置 文件 中 设置 的 名 / 值 对 。 

例如 ， 我 们 将 模块 做 如 下 配置 : 


j 
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SimpleLoginModule required pwfile="password. txt"; 

则 登录 模块 可 以 从 options 映射 表 中 获取 pwfile 设置 。 

该 登录 模块 并 没有 收集 用 户 名 和 密码 ， 这 是 单独 的 handler 需要 做 的 工作 。 这 种 功能 上 
的 分 离 有 助 于 你 在 各 种 情况 下 使 用 相同 的 登录 模块 ， 而 不 用 关心 登录 信息 是 来 自 GUI 对 话 
杠 、 控 制 台 提示 符 还 是 配置 文件 。 

handler 是 在 创建 LoginContext 时 指定 的 。 例 如 ， 


LoginContext context = new LoginContext("Login1", 
new com.sun,security.auth.cal]back.DialogCallbackHandler()) ; 


DialogCal1lbackHandler 会 弹出 一 个 简单 的 GUI 对 话 框 ， 以 获取 用 户 名 和 密码 。 而 
com.sun.security.auth.callback.TextCallbackHandler 则 从 控制 台 获 取 这 些 信息 。 

但 是 ， 在 我 们 的 应 用 程序 中 ， 是 通过 自己 编 
写 的 GUI 来 获得 用 户 名 和 密码 的 (参见 图 9-10 )。 
我 们 创建 了 一 个 简单 的 handler， 仅 仅 用 于 存 
储 和 返回 这 些 信息 ( 见 程序 清单 9-12 )。 

该 handler 有 一 个 简单 的 方法 handle, FA 
于 处 理 Callback 对 象 数 组 。 有 很 多 预定 义 类 ， 比 如 NameCallback 和 PasswordCallback 
等 ， 都 实现 了 Callback 接口 。 也 可 以 添加 自己 的 类 ， 比 如 RetinaScanCallback 等 。 下 面 
这 段 handler 代码 可 能 有 些 不 雅致 ， 因 为 它 要 分 析 callback 对 象 的 类 型 : 

public void handle(Callback[] callbacks) 
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图 9-10 一 个 定制 的 登录 模块 





for (Callback callback : callbacks) 
{ 


if (callback instanceof NameCallback) ... 
else if (callback instanceof PasswordCallback) .. . 
else... 

Ea 

} 


登录 模块 提供 callback 数组 以 满足 认证 的 需要 。 


NameCal back nameCall = new NameCallback("username: "); 
PasswordCallback passCal] = new PasswordCallback("password: ", false); 
cal lbackHandler.handle(new Callback[{] { nameCall, passCall }); 


然后 它 从 callback 中 获取 所 要 的 信息 。 

程序 清单 9-13 中 的 程序 将 显示 一 个 窗 体 ， 用 于 输入 登录 信息 和 系统 属性 名 。 如 果 用 户 通 
过 了 认证 ， 属 性 值 会 在 PrivilegedAction 中 被 取出 。 从 程序 清单 9-14 的 策略 文件 中 可 以 
看 到 ， 只 有 具有 admin 角色 的 用 户 才 具有 对 属性 的 读 取 权 限 。 

正如 前 一 节 中 所 讲 到 的 ， 必 须 将 登录 和 操作 代码 分 开 。 因 此 ， 首 先 创建 两 个 JAR 文件 : 


javac *.java 
jar cvf login.jar JAAS*.class Simple*.class 
jar cvf action.jar SysPropAction.class 








然后 以 如 下 方式 运行 程序 : 


java -classpath login.jar:action.jar 
-Djava. security. policy=JAASTest. policy 
-Djava.security.auth. login.config=jaas.config 
JAASTest 


程序 清单 9-15 说 明了 登录 的 配置 。 

注意 : 有 些 应 用 有 可 能 需要 支持 更 复杂 的 两 阶段 协议 ， 即 只 有 登录 配置 文件 中 的 所 有 模块 
都 认证 成 功 ， 该 登录 才 会 被 提交 。 更 多 详细 信息 ， 请 参阅 下 面 地 址 的 登录 模块 开发 指南 : 
http://docs.oracle.com/javase/7/docs/technotes/guides/security/jaas/JAASLMDevGuide.html . 





1 package jaas; 

2 

3 import java.security.*; 
4 import java.util.*; 


5 

6 /** 

7 *Aprincipal with a named value (such as "role=HR" or “username=harry"). 
8 * 

9 public class SimplePrincipal implements Principal 

10 { 

11 private String descr; 

2 private String value; 


14 /** 

15 * Constructs a SimplePrincipal to hold a description and a value. 
16 * @param descr the description 

17 * @param value the associated value 

18 */ 


19 public SimplePrincipal (String descr, String value) 


21 this.descr = descr; 

22 this.value = value; 

23 } 

24 

25 /** 

26 * Returns the role name of this principal. 
27 * @return the role name 

28 t 


23 public String getName () 
{ 


31 return descr + "=" + value; 

32 } 

33 

34 public boolean equals(Object otherObject) 

35 { 

36 if (this == otherObject) return true; 

37 if (otherObject == null) return false; 

38 if (getClass() != otherObject.getClass()) return false; 


39 SimplePrincipal other = (SimplePrincipal) otherObject; 
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40 return Objects.equals(getName(), other.getName()); 
41 } 

42 

43 public int hashCode() 

44 { 

45 return Objects.hashCode (getName ()) ; 





package jaas; 


1 

2 

3 import java.io. *; 

4 import java.nio.file.*; 
s import java.security.*; 
6 import java.util.*; 

7 import javax.security.auth.*; 

8 import javax.security.auth.callback.*; 
9 import javax.security.auth.login.*; 

10 import javax.security.auth.spi.*; 


12 /** 

13 * This login module authenticates users by reading usernames, passwords, and roles from a text 
14 * file, 

15 */ 

16 public class SimpleLoginModule implements LoginModule 

17 { 

18 private Subject subject; 

19 private CallbackHandler callbackHandler; 

20 private Map<String, ?> options; 


22 public void initialize(Subject subject, CallbackHandler callbackHandler, 


23 Map<String, ?> sharedState, Map<String, ?> options) 

24 

25 this.subject = subject; 

26 this.callbackHandler = callbackHandler: 

27 this.options = options; 

28 } 

29 

30 public boolean login() throws LoginException 

31 

32 if (callbackHandler == null) throw new LoginException("no handler"); 
33 

34 NameCall back nameCall = new NameCallback("username: "); 

35 PasswordCallback passCall = new PasswordCallback("password: ", false); 
36 try 

37 { 

38 callbackHandler.handle(new Callback[] { nameCall, passCall }); 

39 } 

40 catch (UnsupportedCal lbackException e) 


42 LoginException e2 = new LoginException("Unsupported callback"); 





e2,initCause(e) ; 
throw e2; 


catch (IOException e) 

{ 
LoginException e2 = new LoginException("I/0 exception in callback"); 
e2.initCause(e); 
throw e2; 


} 
try 
return checkLogin(nameCall.getName(), passCall.getPassword()); 


catch (IOException ex) 

{ 
LoginException ex2 = new LoginException() ; 
ex2.initCause(ex) ; 
throw ex2; 


[** 

* Checks whether the authentication information is valid. If it is, the subject acquires 
* principals for the user name and role. 

* @aram username the user name 

* @param password a character array containing the password 

* @return true if the authentication information is valid 

* 

/ 


private boolean checkLogin(String username, char[] password) throws LoginException, IOException 
try (Scanner in = new Scanner(Paths.get("" + options.get("pwfile")), "UTF-8")) 


while (in. hasNextLine()) 


{ 
String[] inputs = in.nextLine().split("\\|"); 
if (inputs [0].equals(username) && Arrays.equals(inputs[1].toCharArray(), password) ) 
String role = inputs(2] ; 
Set<Principal> principals = subject.getPrincipals() ; 
principals.add(new SimplePrincipal ("username’, username) ) ; 
principals.add(new SimplePrincipal ("role", role)); 
return true; 
} 
} 
return false; 
} 
} 
public boolean logout () 
{ 
return true; 
} 


public boolean abort() 
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98 { 
99 return true; 
10 } 


102 public boolean commit() 


104 return true; 





ania 
, import javax.security.auth.callback.*; 

a 

6 Mi simple callback handler presents the given user name and password. 
public class SimpleCallbackHandler implements CallbackHandler 

9 


10 private String username; 
11 private char[] password; 


3 /** 
14 * Constructs the callback handler. 

15 * @param username the user name 

16 * @param password a character array containing the password 
17 */ 


18 public SimpleCallbackHandler(String username, char[] password) 


20 this.username = username; 
21 this.password = password; 
2 } 


24 public void handle(Callback[] callbacks) 
{ 
26 for (Callback callback : callbacks) 


28 if (callback instanceof NameCallback) 

i ((NameCallback) callback). setName (username) ; 

a else if (callback instanceof PasswordCal]back) 

s i ((PasswordCallback) callback) .setPassword (password) ; 





1 package jaas; 
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2 

3 import java.awt.*; 

4 import javax.swing.*; 

5 

6 /** 

7 *This program authenticates a user via a custom login and then looks up a system property with 
8 * the user's privileges. 

9 * Q@version 1.02 2016-05-10 

10 * @author Cay Horstmann 

u */ 

12 public class JAASTest 

3 { 

4 public static void main(final String[] args) 

15 { 

16 System.setSecurityManager(new SecurityManager()); 
17 EventQueue.invokeLater(() -> 

18 { 

19 JFrame frame = new JAASFrame() ; 

20 frame. setDefaul tCloseOperation(JFrame.EXIT_ON_CLOSE) ; 
21 frame.setTitle("JAASTest”) ; 

22 frame.setVisible(true) ; 

23 及; 

24 } 

25 } 









ge ely Mutt SAN E A A 





grant codebase "file: login.jar" 
{ 


l 
2 
3 permission java.awt.AWTPermission "showWindowWi thoutWarningBanner' ; 

4 permission java.awt.AWTPermission "“accessEventQueue’ ; 

5 permission javax.security.auth.AuthPermission "createLoginContext.Login1"; 
6 permission javax.security.auth.AuthPermission "doAsPrivileged"; 

7 permission javax.security.auth.AuthPermission “modi fyPrincipals”; 

8 permission java.io.FilePermission "jaas/password.txt", "read"; 

9 


F; 
10 
11 grant principal jaas.SimplePrincipal "role=admin" 


12 
3 permission java.util.PropertyPermission "*", "read"; 


w p 








1 Loginl 
F. 
3 jaas.SimpleLoginModule required pwfile="jaas/password.txt" debug=true; 


4; 





e void handle(Callback[] callbacks) 
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处 理 给 定 的 callback， 如 果 愿 意 ， 可 以 与 用 户 进行 交互 ， 并 且 将 安全 信息 存储 到 
callback 对 象 中 。 





e NameCallback(String prompt) 


e NameCallback(String prompt, String defaultName) 
用 给 定 的 提示 符 和 默认 的 名 字 构 建 一 个 NameCa11back。 

e String getName() 

e void setName(String name) 


设置 或 者 获取 该 callback 所 收集 到 的 名 字 。 
e String getPrompt( ) 


获取 查询 该 名 字 时 所 使 用 的 提示 符 。 
e String getDefaultName( ) 


获取 查询 该 名 字 时 所 使 用 的 默认 名 字 。 





e PasswordCallback(String prompt, boolean echoOn) 


用 给 定 提 示 符 和 回 显 标记 构建 一 个 PasswordCallback。 


echar[] getPassword() 


evoid setPassword(char[] password) 


设置 或 者 获取 该 callback 所 收集 到 的 密码 。 
e String getPrompt() 

获取 查询 该 密码 时 所 使 用 的 提示 符 。 
e boolean isEchoOn( ) 


获取 查询 该 密码 时 所 使 用 的 回 显 标记 。 





evoidinitialize(Subjectsubject, CallbackHandlerhandler, 


Map<String,?> sharedState, Map<String,?> options) 
为 了 认证 给 定 的 subject， 初 始 化 该 LoginModule。 在 登录 处 理 期 间 ， 用 给 定 
HY handler 来 收集 登录 信息 ; 使 用 sharedState 映射 表 与 其 他 登录 模块 进行 通信 
options 映 尉 表 包 含 该 模块 实例 的 登录 配置 中 指定 的 名 / 值 对 。 

e boolean login() 
执行 认证 过 程 ， 并 组 装 主体 的 特征 集 。 如 果 登 录 成 功 ， 则 返回 true, 

e boolean commit() 
对 于 需要 两 阶段 提交 的 登录 场景 ， 当 所 有 的 登录 模块 都 成 功 后 ， 调 用 该 方法 。 如 果 操 
作成 功 ， 则 返回 true, 


化 音 IT 





e boolean abort() 
如 果 某 一 登录 模块 失败 导致 登录 过 程 中 断 ， 就 调用 该 方法 。 如 果 操 作成 功 ， 则 返回 true, 
ə boolean logout() 


注销 当前 的 主体 。 如 果 操 作成 功 ， 则 返回 true, 


94 数字 签名 


正如 我 们 前 面 所 说 ，applet 是 在 Java 平台 上 开始 流行 起 来 的 。 实 际 上 ， 人 们 发 现 尽管 他 
们 可 以 编写 出 像 著 名 的 “ nervous text” 那 样 棚 棚 如 生 的 applet， 但 是 在 IDK 1.0 安全 模式 下 
无 法 发 挥 其 一 整套 非常 有 用 的 作用 。 例 如 ， 由 于 JDK 1.0 下 的 applet 要 受到 严密 的 监管 ， 因 
此 ， 即 使 applet 在 公司 安全 内 部 网 上 运行 时 风险 相对 较 小 ，applet 也 无 法 在 企业 内 部 网 上 发 
挥 很 大 的 作用 。Sun 公司 很 快 就 认识 到 ， 要 使 applet 真正 变 得 非常 有 用 ， 用 户 必须 可 以 根据 
applet 的 来 源 为 其 分 配 不 同 的 安全 级 别 。 如 果 applet 来 自 值得 信赖 的 提供 商 ， 并 且 没 有 被 算 
改过 ， 那 么 applet 的 用 户 就 可 以 决定 是 否 给 applet 授予 更 多 的 运行 特权 。 

如 果 要 给 予 一 个 applet 更 多 的 信任 ， 你 必须 知道 下 面 两 件 事 : 

1) 这 个 applet KAWE? 

2) 在 传输 过 程 中 代码 是 否 被 破坏 ? 

在 过 去 的 50 年 里 ， 数 学 家 和 计算 机 科学 家 已 经 开发 出 各 种 各 样 成 熟 的 算法 ， 用 于 确保 数据 
和 电子 签名 的 完整 性 ,在 java.security 包 中 包含 了 许多 这 类 算法 的 实现 ， 而 且 幸 运 的 是 ， 你 
无 需 掌握 相应 的 数学 基础 知识 ， 就 可 以 使 用 java. security 包 中 的 算法 。 在 下 面 几 节 中 ,我 们 
将 要 介绍 消息 摘要 是 如 何 检测 数据 文件 中 的 变化 的 ， 以 及 数字 签名 是 如 何 证 明 签名 者 的 号 份 的 。 


9.4.1 消息 摘要 


消息 摘要 (message digest) 是 数据 块 的 数字 指纹 。 例 如 ， 所 谓 的 SHA1 (安全 散 列 算法 
#1) 可 将 任何 数据 块 ， 无 论 其 数据 有 多 长 ， 都 压缩 为 160 位 (20 字 节 ) 的 序列 。 与 真实 的 指 
纹 一 样 ， 人 们 希望 任何 两 条 消息 都 不 会 有 相同 的 SHA1 指纹 。 当 然 ， 这 是 不 可 能 的 一 因为 只 
存在 2” 个 SHAI 指纹 ， 所 以 肯定 会 有 某 些 消息 具有 相同 的 指纹 。 因 为 2” 是 一 个 很 大 的 数 
字 ， 所 以 存在 重复 指纹 的 可 能 性 微乎其微 ,那么 这 种 重复 的 可 能 性 到 底 小 到 什么 程度 呢 ? 根 
HE James Walsh 在 他 的 《 True Odds: How Risks Affect Your Everyday Life Y ( Merritt Publishing 
出 版 社 1996 年 出 版 ) 一 书 中 所 叙述 的 ， 人 死 于 雷击 的 概率 为 三 万 分 之 一 。 现 在 ,假设 有 9 个 
人 ， 比 如 你 不 喜欢 的 9 个 经 理 或 者 教授 ， 你 和 他 们 所 有 的 人 都 死 于 雷击 的 概率 ， 比 伪造 的 消 
息 与 原 有 消息 具有 相同 的 SHA1 指纹 的 概率 还 要 高 。( 当 然 ， 可 能 有 你 不 认识 的 其 他 10 个 以 
上 的 人 会 死 于 雷击 ， 但 这 里 我 们 讨论 的 是 你 选择 的 特定 的 人 的 死亡 概率 。) 

消息 摘要 具有 两 个 基本 属性 : 

1) 如 果 数 据 的 1 位 或 者 几 位 改变 了 ， 那 么 消息 摘要 也 将 改变 。 

2) 拥有 给 定 消息 的 伪造 者 不 能 创建 与 原 消息 具有 相同 摘要 的 假 消息 。 
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当然 ， 第 二 个 属性 又 是 一 个 概率 问题 。 让 我 们 来 看 看 下 面 这 位 亿 万 富翁 留 下 的 遗嘱 ; 

我 死 了 之 后 ， 我 的 财产 将 由 我 的 孩子 平分 ， 但 是 ， 我 的 儿子 George 应 该 拿 不 到 一 个 子 。” 

这 份 遗嘱 的 SHA1 指纹 为 : 

12 5F 09 03 E7 31 30 19 2E A6 E7 E4 90 43 84 B4 38 99 BF 67 

这 位 有 疑心 病 的 父亲 将 这 份 遗 嘱 交 给 一 位 律师 保存 ， 而 将 指纹 交 给 另 一 位 律师 保存 。 现 
在 ， 假 设 George 能 够 贿赂 那 位 保存 遗嘱 的 律师 ， 他 想 修改 这 份 遗嘱 ， 使 得 Bill 一 无 所 得 。 
当然 ， 这 需要 将 原 指纹 改 为 下 面 这 样 完全 不 同 的 位 模式 : 

7D F6 AB 08 EB 40 EC CD AB 74 ED E9 86 F9 ED 99 D1 45 B1 57 

那么 George 能 够 找到 与 该 指纹 相 匹配 的 其 他 文字 吗 ? 如 果 从 地 球形 成 之 时 ， 他 就 很 自豪 
地 拥有 10 亿 台 计算 机 ， 每 台 计 算 机 每 秒 钟 能 处 理 一 百 万 条 信息 ， 他 依然 无 法 找到 一 个 能 够 
蔡 换 的 遗嘱 。 

人 们 已 经 设计 出 大 量 的 算法 ， 用 于 计算 这 些 消息 摘要 ， 其 中 最 著名 的 两 种 算法 是 SHA1 
和 MD5。SHAI1 是 由 美国 国家 标准 和 技术 学 会 开发 的 加 密 散 列 算 法 ，MD5 是 由 麻 省 理工 学 
院 的 Ronald Rivest 发 明 的 算法 。 这 两 种 算法 都 使 用 了 独特 巧妙 的 方法 对 消息 中 的 各 个 位 进行 
扰乱 。 如 果 要 了 解 这 些 方法 的 详细 信息 ， 请 参阅 William Stallings 撰写 的 《 Cryptography and 
Network Security 第 5 版 》 一 书 ， 该 书 由 Prentice Hall 出 版 社 于 2011 年 出 版 。 但 是 ， 人 们 在 
这 两 种 算法 中 发 现 了 某 些 微妙 的 规律 性 ， 因 此 美国 国家 标准 和 技术 学 会 建议 切换 到 更 强 的 加 
密 算 法 上 ， 例 如 SHA-256、SHA-384 和 SHA-S12。 

Java 编程 语言 已 经 实现 了 MDS, SHA-1, SHA-256, SHA-384 和 SHA-512, MessageDigest 
类 是 用 于 创建 封装 了 指纹 算法 的 对 象 的 “工厂 "， 它 的 静态 方法 getInstance 返回 继承 了 
MessageDigest 类 的 某 个 类 的 对 象 。 这 意味 着 MessageDigest 类 能 够 承担 下 面 的 双重 职责 : 

e 作为 一 个 工厂 类 。 

e 作为 所 有 消息 摘要 算法 的 超 类 。 

例如 ， 下 面 是 如 何 获 取 一 个 能 够 计算 SHA 指纹 的 对 象 的 方法 : 


MessageDigest alg = MessageDigest.getInstance("SHA-1"); 


(如 果 要 获取 计算 MDS 的 对 象 ， 请 使 用 字符 串 “MD5” 作 为 getInstance 的 参数 。) 

在 获取 MessageDigest 对 象 之 后 ， 可 以 通过 反复 调用 update 方法 ， 将 信息 中 的 所 有 
字 节 提供 给 该 对 象 。 例 如 ， 下 面 的 代码 将 文件 中 的 所 有 字 节 传 给 上 面 创 建 的 alg 对 象 ， 以 执 
行 指 纹 算法 : 

InputStream in =... 

int ch; 


while ((ch = in.read()) != -1) 
alg.update((byte) ch); 


男 外 ， 如 果 这 些 字 节 存放 在 一 个 数组 中 ， 那 就 可 以 一 次 完成 整个 数组 的 更 新 : 


byte[] bytes=...; 
alg.update (bytes) ; 
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当 完 成 上 述 操作 后 ， 调 用 digest 方法 。 该 方法 按照 指纹 算法 的 要 求 补 齐 输入 ， 并 且 进 
行 相应 的 计算 ， 然 后 以 字 节 数组 的 形式 返回 消息 摘要 。 

byte[] hash = alg.digest() ; 

程序 清单 9-16 中 的 程序 计算 了 一 个 消息 摘要 ， 既 可 以 用 SHA， 也 可 以 使 用 MD5 来 计 
算 。 可 以 按 如 下 方式 运行 程序 : 


java hash.Digest hash/input. txt 


java hash.Digest hash/input.txt MD5 






package hash; 


import java.io.*; 
import java.nio.file.*; 
import java.security.*; 


| 

* This program computes the message digest of a file. 
* @ersion 1.20 2012-06-16 

10 * @author Cay Horstmann 

u */ 

12 public class Digest 

3 { 

14 /** 

15 * @param args args[0] is the filename, args[1] is optionally the algorithm 
16 * (SHA-1, SHA-256, or MD5) 

7 */ 


won Nu ao wo > WY N ë e 


18 public static void main(String[] args) throws IOException, General SecurityException 


19 { 


20 String algname = args.length >= 2 ? args[1] : "SHA-1"; 
21 MessageDigest alg = MessageDigest.getInstance(algname) ; 
22 byte[] input = Files.readAllBytes(Paths.get(args[0])); 
23 byte[] hash = alg.digest (input) ; 

24 String d = ""; 

25 for (int i = 0; i < hash. length; i++) 

26 { 

27 int v = hash[i] & OxFF; 

28 if (v < 16) d += "0"; 

29 d += Integer.toString(v, 16).toUpperCase() + " "; 
30 } 


31 System.out.printIn(d) ; 
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返回 实现 指定 算法 的 MessageDigest 对 象 。 如 果 没 有 提供 该 算法 ， 则 抛 出 一 个 
NoSuchAlgorithmException 异常 。 
e void update(byte input) 
e void update(byte[] input) 
e void update(byte[] input, int offset, int len) 
使 用 指定 的 字 节 来 更 新 摘要 。 
ebyte[] digest() 
完成 散 列 计算 ， 返回 计算 所 得 的 摘要 ， 并 复位 算法 对 象 。 
e void reset() 


重 置 摘要 。 
94.2 消息 签名 


在 上 一 节 中 ， 我 们 介绍 了 如 何 计算 消息 摘要 ， 即 原始 消息 的 指纹 的 方法 。 如 果 消 息 改变 
了 ， 那 么 改变 后 的 消息 的 指纹 与 原 消息 的 指纹 将 不 匹配 。 如 果 消 息 和 它 的 指纹 是 分 开 传送 
WN, 那么 接收 者 就 可 以 检查 消息 是 否 被 算 改 过 。 但 是 ， 如 果 消 息 和 指纹 同时 被 截获 了 ， 对 消 
县 进行 修改 ， 再 重新 计算 指纹 ， 就 是 一 件 很 容易 的 事情 。 毕 竟 ， 消 息 摘要 算法 是 公开 的 ， 不 
需要 使 用 任何 密 钥 。 在 这 种 情况 下 ， 假 消息 和 新 指纹 的 接收 者 永远 不 会 知道 消息 已 经 被 算 
改 。 数 字 签 名 解决 了 这 个 问题 。 

为 了 了 解数 字 签 名 的 工作 原理 ， 我 们 需要 解释 关于 公共 密 钥 加 密 技术 领域 中 的 几 个 概 
念 。 公 共 密 钥 加 密 技 术 是 基于 公共 密 钥 和 私有 密 钥 这 两 个 基本 概念 的 。 它 的 设计 思想 是 你 可 
以 将 公共 密 钥 告诉 世界 上 的 任何 人 ， 但 是 ， 只 有 自己 才 持 有 私有 密 钥 ， 重 要 的 是 你 要 保护 你 
的 私有 密 钥 ， 不 将 它 泄漏 给 其 他 任何 人 。 这 些 密 钥 之 间 存 在 一 定 的 数学 关系 ， 但 是 这 种 关系 
的 具体 性 质 对 于 实际 的 编程 来 说 并 不 重要 。( 如 果 你 有 兴趣 ， 可 以 参阅 http://www.cacr.math. 
uwaterloo.ca/ hac/ 站 点 上 的 《 The Handbook of Applied Cryptography 》 一 书 。) 

密 钥 非常 长 ， 而 且 很 复杂 。 例 如 ， 下 面 是 一 对 匹配 的 数字 签名 算法 (DSA) 的 公共 密 钥 
和 私有 密 钥 。 

公共 密 钥 : 

p: fcab82ce8el2caba26efccf7110e526db078b05edecbcd1eb4a208f3ae1617ae01F35b91a47e6df63413c5e12ed089 

9bcd132acd50d99151bdc43ee737592e17 

q: 962eddcc369cba8ebb260ee6b6a126d9346e38c5 


g: 678471b27a9cf44ee91a49¢5147db1a9aaf24405a434d6486931d2d14271b9e35030b71Fd73da179069b32e293563 
0e1c2062354d0da20a6c416e50be794ca4 


y: cOb6e67b4ac098eb1a32c5f8c4c1f0e7e6Fb9d832532e27d0bdab9ca2d2a8123ce5a8018b8161a760480Fadd040b92 
7281ddb22cbh9bc4df596d7de4d1b977d50 


私有 密 钥 : 


p: fca682ce8el2caba26efccf7110e526db078b05edecbcd1eb4a208f3ae1617ae01f35b91a47e6df63413c5e12ed089 
9bcd132acd50d99151bdc43ee737592e17 
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q: 962eddcc369cha8ebb260ee6b6a126d9346e38c5 


g: 678471b27a9cf44ee91a49c5147db1a9aaf244f05a434d6486931d2d14271b9e35030b71d7 3da179069b32e293563 

0e1c2062354d0da20a6c416e50be794ca4 

x: 146c09881656cc6c51f27ea6c3a91b85ed1d70a 

在 现实 中 ， 几 乎 不 可 能 用 一 个 密 钥 去 推算 出 另 一 个 密 钥 。 也 就 是 说 ， 即 使 每 个 人 都 知道 
你 的 公共 密 钥 ， 不 管 他 们 拥有 多 少 计算 资源 ， 他 们 一 者 子 也 无 法 计算 出 你 的 秘 有 密 钥 。 

任何 人 都 无 法 根据 公共 密 钥 来 推算 私有 密 钥 ， 这 似乎 让 人 难以 置信 。 但 是 时 至 今日 ， 还 
没有 人 能 够 找到 一 种 算法 ， 来 为 现在 常用 的 加 密 算法 进行 这 种 推算 。 如 果 密 钥 足 够 长 ， 那 么 
要 是 使 用 穷 举 法 一 一 也 就 是 直接 试验 所 有 可 能 的 密 钥 一 一 所 需要 的 计算 机 将 比 用 太阳 系 中 的 
所 有 原子 来 制造 的 计算 机 还 要 多 ， 而 且 还 得 花费 数 千 年 的 时 间 。 当 然 ， 可 能 会 有 人 提出 比 穷 
举 更 灵活 的 计算 密 钥 的 算法 。 例 如 ，RSA 算法 (该 加 密 算 法 由 Rivest, Shamir 和 Adleman 发 
明 ) 就 利用 了 对 数值 巨大 的 数字 进行 因数 分 解 的 困难 性 。 在 最 近 20 年 里 ， 许 多 优秀 的 数学 家 
都 在 尝试 提出 好 的 因数 分 解 算法 ,但 是 迄今 为 止 都 没有 成 功 。 据 此 ， 大 多 数 密码 学 者 认为 ， 
拥有 2000 位 或 者 更 多 位 “ 模 数 ”的 密 钥 目 前 是 完全 安全 的 ， 可 以 抵御 任何 攻击 。DSA 被 认 
为 具有 类 似 的 安全 性 。 

图 9-11 展示 了 实践 中 这 种 机 制 是 如 
何 工作 的 。 

假设 Alice 想 要 给 Bob 发 送 一 个 消 
息 ，Bob 想 知 道 该 消息 是 否 来 自 Alice， 
而 不 是 冒名 顶替 者 。Alice 写 好 了 消息 ， 
并 且 用 她 的 私有 密 钥 对 该 消息 摘要 签名 。 
Bob 得 到 了 她 的 公共 密 钥 的 拷贝 ， 然 后 
Bob 用 公共 密 钥 对 该 签名 进行 校 验 。 如 
果 通 过 了 校 验 ， 则 Bob 可 以 确认 以 下 两 
个 事实 : 

1 ) 原始 消息 没有 被 自 改 过 。 
AAMAS. PIASTRE ge pala mre 
Bob 用 于 校 验 的 公共 密 钥 相 匹 配 的 密 钥 。 图 9-11 使 用 DSA 进行 公共 密 钥 签名 的 交换 

你 可 以 看 到 私有 密 钥 的 安全 性 为 什么 是 最 重要 的 。 如 果 某 个 人 偷 了 Alice HAA A, 
或 者 政府 要 求 她 交 出 私有 密 钥 ， 那 么 她 就 麻烦 了 。 人 小 偷 或 者 政府 代表 就 可 以 假扮 她 的 身份 来 
发 送 消 息 ， 例 如 资金 转账 指令 ， 而 其 他 人 则 会 相信 这 些 消息 确实 来 自 于 Alice. 


9.4.3” 校 验 签名 


JDK 配 有 一 个 keytool 程序 ， 该 程序 是 一 个 命令 行 工 具 ， 用 于 生成 和 管理 一 组 证 书 。 
我 们 期 望 该 工具 的 功能 最 终 能 够 被 答 和 人 到 其 他 更 加 用 户 友 好 的 程序 中 去 。 但 我 们 现在 要 做 的 
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是 ， 使 用 keytool 工具 来 展示 Alice 是 如 何 对 一 个 文档 进行 签名 并 且 将 它 发 送 给 Bob 的 ， 而 
Bob 又 是 如 何 校 验 该 文档 确实 是 由 Alice 签名 ， 而 不 是 冒名 顶替 的 。 

keytool 程序 负责 管理 密 钥 库 、 证 书 数据 库 和 私有 /公有 密 钥 对 。 密 钥 库 中 的 每 一 项 都 有 一 
个 “别名 ”。 下 面 展示 的 是 Alice 如 何 创建 一 个 密 钥 库 alice.certs 并 且 用 别名 生成 一 个 密 钥 对 。 


keytool -genkeypair -keystore alice.certs -alias alice 


当 新 建 或 者 打开 一 个 密 钥 库 时 ， 系 统 将 提示 你 输入 密 钥 库 口令 ， 在 下 面 的 这 个 例子 中 ， 
口令 就 使 用 secret ， 如 果 你 要 将 keytool 生成 的 密 钥 库 用 于 重要 的 应 用 ， 那 么 你 需要 选择 
一 个 好 的 口令 来 保护 这 个 文件 。 

当 生 成 一 个 密 钥 时 ， 系 统 提 示 你 输入 下 面 这 些 信息 : 


Enter keystore password: secret 

Reenter new password: secret 

What is your first and last name? 
[Unknown]: Alice Lee 

What is the name of your organizational unit? 
[Unknown]: Engineering 

What is the name of your organization? 
[Unknown]: ACME Software 

What is the name of your City or Locality? 
[Unknown]: San Francisco 

What is the name of your State or Province? 
[Unknown]: CA 

What is the two-letter country code for this unit? 
[Unknown]: US 

Is <CN=Alice Lee, OU=Engineering, O=ACME Software, L=San Francisco, ST=CA, C=US> correct? 
[no]: yes 


keytool 工具 使 用 X.500 格式 的 名 字 ， 它 包含 常用 名 ( CN)、 机 构 单位 (OU) BLY 
(O), 地 点 〈L 入 JH (ST) 和 国 别 (C) 等 成 分 ， 以 确定 密 钥 持 有 者 和 证 书 发 行者 的 身份 。 

最 后 ， 必 须 设 定 一 个 密 钥 口令 ,或 者 按 回 车 键 ， 将 密 钥 库 口 令 作 为 密 钥 口令 来 使 用 。 

假设 Alice 想 把 她 的 公共 密 钥 提供 给 Bob， 她 必须 导出 一 个 证 书 文件 : 

keytool -exportcert -keystore alice.certs -alias alice -file alice.cer 

XAT, Alice 就 可 以 把 证 书 发 送 给 Bob. “4 Bob 收 到 该 证 书 时 ， 他 就 可 以 将 证 书 打印 出 来 

keytool -printcert -file alice.cer 


打印 的 结果 如 下 : 


Owner: CN=Alice Lee, OU=Engineering, 0=ACME Software, L=San Francisco, ST=CA, C=US 
Issuer: CN=Alice Lee, OU=Engineering, O=ACME Software, L=San Francisco, ST=CA, C=US 
Serial number: 470835ce 
Valid from: Sat Oct 06 18:26:38 PDT 2007 until: Fri Jan 04 17:26:38 PST 2008 
Certificate fingerprints: 

MDS: BC: 18:15:27:85:69:48:B1:5A:C3:0B:1C:C6:11:B7:81 

SHA1: 31:0A:A0:B8:(2: 8B: 3B:B6:85:7C:EF:C0:57:65:94:95:61:47:6D: 34 

Signature algorithm name: SHAlwithDSA 

Version: 3 
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如 果 Bob 想 检 查 他 是 否 得 到 了 正确 的 证 书 ， 可 以 给 Alice 打 电 话 ， 让 她 在 电话 里 读 出 证 
书 的 指纹 。 


注意 : 有 些 证 书 发 放 者 将 证 书 指纹 公布 在 他 们 的 网 站 上 。 例 如 ， 要 检查 jre/1ib/ 
security 目录 中 的 密 钥 库 里 的 VeriSign 公司 的 证 书 ， 可 以 使 用 -1ist 选项 : 


keytool -list -v -keystore jre/lib/security/cacerts 


该 密 钥 库 的 口令 是 changeit。 在 该 密 钥 库 中 有 一 个 证 书 是 : 


Owner: OU=VeriSign Trust Network, OU="(c) 1998 VeriSign, Inc. - For authorized use only", 
QU=Class 1 Public Primary Certification Authority - G2, O="VeriSign, Inc.", C=US 
Issuer: OU=VeriSign Trust Network, OU="(c) 1998 VeriSign, Inc. - For authorized 
use only", OU=Class 1 Public Primary Certification Authority - G2, O="VeriSign, Inc.", 
C=US 
Serial number: 4cc7eaaa983e71d39310F83d3a899192 
Valid from: Sun May 17 17:00:00 PDT 1998 until: Tue Aug 01 16:59:59 PDT 2028 
Certificate fingerprints: 
MDS: DB:23:3D:F9:69:FA:4B:B9:95:80:44:73:5E:7D:41:83 
SHAL: 27:3E:61:24:57:FD:C4:F9:0C:55:E8:2B:56:16:7F:62:F5:32:65:47 


通过 访问 网 址 http://www.verisign.com/repository/root.html， 就 可 以 核实 该 证 书 的 有 效 性 。 
一 旦 Bob 信任 该 证 书 ， 他 就 可 以 将 它 导 入 密 钥 库 中 。 


keytool -importcert -keystore bob.certs -alias alice -file alice.cer 


O 警告 : 绝对 不 要 将 你 并 不 完全 信任 的 证 书 导入 到 密 钥 库 中 。 一 旦 证 书 添 加 到 密 钥 库 中 ， 
使 用 密 钥 库 的 任何 程序 都 会 认为 这 些 证 书 可 以 用 来 对 签名 进行 校 验 。 
现在 Alice 就 可 以 给 Bob 发 送 签 过 名 的 文档 了 。jarsigner 工具 负责 对 JAR 文件 进行 签 
名 和 校 验 ，Alice 只 需要 将 文档 添加 到 要 签名 的 JAR 文件 中 。 
jar cvf document.jar document. txt 


然后 她 使 用 jarsigner 工具 将 签名 添加 到 文件 中 ， 她 必须 指定 要 使 用 的 密 钥 库 、JAR 
文件 和 密 钥 的 别名 。 


jarsigner -keystore alice.certs document.jar alice 


当 Bob 收 到 JAR 文件 时 ， 他 可 以 使 用 jarsigner 程序 的 -verify 选项 ， 对 文件 进行 


jarsigner -verify -keystore bob.certs document ,]ar 


Bob 不 需要 设 定 密 钥 别名 。jarsigner 程序 会 在 数字 签名 中 找到 密 钥 所 有 者 的 X.500 名 
字 ， 并 在 密 钥 库 中 搜寻 匹配 的 证 书 。 
如 果 JAR 文件 没有 受到 破坏 而 且 签 名 匹配 ， 那 么 jarsigner 程序 将 打印 : 


jar verified. 


和 否则， 程序 将 显示 一 个 出 错 消 息 。 
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9.4.4 ”认证 问题 


假设 你 从 朋友 Alice 那 接收 到 一 个 消息 ， 该 消息 是 Alice 用 她 的 私有 密 钥 签名 的 ， 使 用 的 
签名 方法 就 是 我 们 刚刚 介绍 的 方法 。 你 可 能 已 经 有 了 她 的 公共 密 钥 ,或 者 你 能 够 容易 地 获得 
她 的 公共 密 钥 ， 比 如 问 她 要 一 个 密 钥 拷贝 ， 或 者 从 她 的 Web 页 中 获得 密 钥 。 这 时 ， 你 就 可 以 
校 验 该 消息 是 否 是 Alice 签 过 名 的 ， 并 且 有 没有 被 破坏 过 。 现 在 ， 假 设 你 从 一 个 声称 代表 某 
著名 软件 公司 的 陌生 人 那里 获得 了 一 个 消息 ， 他 要 求 你 运行 消息 附带 的 程序 。 这 个 陌生 人 其 
至 将 他 的 公共 密 钥 的 拷贝 发 送 给 你 ， 以 便 让 你 校 验 他 是 否 是 该 消息 的 作者 。 你 检查 后 会 发 现 
该 签名 是 有 效 的 ， 这 就 证 明 该 消息 是 用 匹配 的 私有 密 钥 签 名 的 ， 并 且 没 有 遭 到 破坏 。 

此 时 你 要 小 心 : 你 仍然 不 清楚 谁 写 的 这 条 消息 。 任 何人 都 可 以 生成 一 对 公共 密 钥 和 私有 
密 钥 ， 再 用 私有 密 钥 对 消息 进行 签名 ， 然 后 把 签名 好 的 消息 和 公共 密 钥 发 送 给 你 。 这 种 确定 
发 送 者 身份 的 问题 称 为 “认证 问题 ”。 

解决 这 个 认证 问题 的 通常 做 法 是 比较 简单 的 。 假 设 陌 生 人 和 你 有 一 个 你 们 俩 都 值得 信赖 
的 共同 熟人 。 假 设 陌生 人 亲自 约见 了 该 熟人 ， 将 包含 公共 密 钥 的 磁盘 交 给 了 他 。 后 来 ， 你 的 
询 人 与 你 见面 ， 向 你 担保 他 与 该 陋 生 人 见 了 面 ， 并 且 该 陌生 人 确实 在 那 家 著名 的 软件 公司 工 
作 ， 然 后 将 磁盘 交 给 你 (参见 图 9-12 )。 这 样 一 来 ， 你 的 熟人 就 证 明了 陌生 人 身份 的 真实 性 。 





图 9-12 通过 一 个 值得 信赖 的 中 间 人 进行 认证 


事实 上 ,你 的 熟人 并 不 需要 与 你 见面 。 取 而 代 之 的 是 ， 他 可 以 将 他 的 私有 签名 应 用 于 陌 
生 人 的 公共 密 钥 文件 之 上 即 可 (参见 图 9-13 )。 

当 你 拿 到 公共 密 钥 文件 之 后 ， 就 可 以 检验 你 的 熟人 的 签名 是 否 真实 ， 由 于 你 信任 他 ， 因 
此 你 确信 他 在 添加 他 的 签名 之 前 ， 确 实 核实 了 陌生 人 的 身份 。 

然而 ， 你 们 之 间 可 能 没有 共同 的 熟人 。 有 些 信任 模型 假设 你 们 之 间 总 是 存在 一 个 “ 信 
任 链 ” 一 一 即 一 个 共同 熟人 的 链 路 一 一 这 样 你 就 可 以 信任 该 链 中 的 每 个 成 员 。 当 然 ， 实 际 
情况 并 不 总 是 这 样 。 你 可 能 信任 你 的 熟人 Alice, 而且 你 知道 Alice 信任 Bob， 但 是 你 不 了 
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解 Bob， 因 此 你 没有 把 握 究竟 是 不 是 该 信任 他 。 其 他 的 信任 模型 则 假设 有 一 个 我 们 大 家 都 信 
任 的 慈善 大 佬 ， 在 扮演 这 个 角色 的 公司 中 ， 最 有 名 的 是 VeriSign 公司 (http://www.verisign. 


com), 





图 9-13 通过 受信 赖 的 中 间 人 的 签名 进行 认证 


你 常常 会 遇 到 由 负责 担保 他 人 身份 的 一 个 或 多 个 实体 签署 的 数字 签名 ， 你 必须 评估 一 下 
究竟 能 够 在 多 大 程度 上 信任 这 些 身 份 认 证 人 。 你 可 能 非常 信赖 VeriSign 公司 ， 因 为 也 许 你 在 
许多 网 页 中 都 看 到 过 他 们 公司 的 标志 ， 或 者 你 曾经 听 说 过 ， 每 当 有 新 的 万 能 密 钥 产生 时 ， 他 
们 就 会 要 求 在 一 个 非常 保密 的 会 议 室 中 聚集 众多 撕 着 黑色 公文 包 的 人 进行 磋商 。 

然而 ， 对 于 实际 被 认证 的 对 象 ， 你 应 该 抱 有 一 个 符合 实际 的 期 望 : 在 认证 公共 密 钥 时 ， 
VeriSign 公司 的 CEO 也 不 会 亲自 去 会 见 每 个 人 或 者 公司 人 代表。 直接 在 Web 页 面 上 填 一 份 表 
格 ， 并 支付 少量 的 费用 ， 就 可 以 获得 一 个 “第 一 类 (class 1)” ID, 包含 在 证 书 中 的 密 钥 将 被 
发 送 到 指定 的 邮件 地 址 。 因 此 ， 你 有 理由 相信 该 电子 邮件 是 真实 的 ， 但 是 密 钥 申请 人 也 可 能 
填 人 任意 名 字 和 机 构 。 还 有 其 他 对 身份 信息 的 检验 更 加 严格 的 ID 类 别 。 例 如 ， 如 果 是 “第 
三 类 (class 3)” ID, VeriSign 将 要 求 密 钥 申 请 人 必须 进行 身份 公证 ， 公 证 机 构 将 要 核实 企业 
申请 者 的 财务 信用 资质 。 其 他 认证 机 构 将 采用 不 同 的 认证 程序 。 因 此 ， 当 你 收 到 一 条 经 过 认 
证 的 消息 时 ， 重 要 的 是 你 应 该 明日 它 实 际 上 认证 了 什么 。 
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945 证 书签 名 


在 9.4.3 节 中 ， 你 已 经 看 到 了 Alice 如 何 使 用 自 签 名 的 证 书 向 Bob 分 发 公共 密 钥 。 但 是 ， 
Bob 需要 通过 校 验 Alice 的 指纹 以 确保 这 个 证 书 是 有 效 的 。 

假设 Alice 想 要 给 同事 Cindy 发 送 一 条 经 过 签名 的 消息 ， 但 是 Cindy 并 不 希望 因为 要 校 
验 许多 签名 指纹 而 受到 困扰 。 因 此 ， 假 设 有 一 个 Cindy 信任 的 实体 来 校 验 这 些 签名 。 在 这 个 
例子 中 ，Cindy 信任 ACME 软件 公司 的 信息 资源 部 。 

这 个 部 门 负责 证 书 授权 (CA) 的 运作 。ACME 的 每 个 人 在 其 密 钥 库 中 都 有 CA 的 公共 密 
钥 ， 这 是 由 一 个 专门 负责 详细 核查 密 钥 指纹 的 系统 管理 员 安 装 的 。CA 对 ACME 雇员 的 密 铀 
进行 签名 ， 当 他 们 在 安装 彼此 的 密 钥 时 ， 密 钥 库 将 隐 含 地 信任 这 些 密 钥 ， 因 为 它们 是 由 一 个 
可 信任 的 密 钥 签名 的 。 

下 面 展 示 了 可 以 如 何 模仿 这 个 过 程 。 首 先 需要 创建 一 个 密 钥 库 acmesoft.Certs, Æ 
一 个 密 钥 对 并 导出 公共 密 钥 。 


keytool -genkeypair -keystore acmesoft.certs -alias acmeroot 
keytool -exportcert -keystore acmesoft.certs -alias acmeroot -file acmeroot.cer 


其 中 的 公共 密 钥 被 导 和 人 到 了 一 个 自 签名 的 证 书 中 ， 然 后 将 其 添加 到 每 个 雇员 的 密 钥 库 中 : 

keytool -importcert -keystore cindy.certs -alias acmeroot -file acmeroot.cer 

如 果 Alice 要 发 送 消息 给 Cindy 以 及 ACME 软件 公司 的 其 他 任何 人 ， 她 需要 将 她 目 己 的 
证 书签 名 - 并 提交 给 信息 资源 部 。 但 是 ， 这 个 功能 在 keytool 程序 中 是 缺失 的 。 在 本 书 附 市 
的 代码 中 ， 我 们 提供 了 一 个 CertificateSigner 类 来 弥补 这 个 问题 。ACME 软件 公司 的 授 
权 机 构成 员 将 负责 核实 Alice 的 身份 ， 并 且 生 成 如 下 的 签名 证 书 : 


java CertificateSigner -keystore acmesoft.certs -alias acmeroot 
-infile alice.cer -outfile alice_signedby_acmeroot.cer 


证 书签 名 器 程序 必须 拥有 对 ACME 软件 公司 密 钥 库 的 访问 权限 ， 并 且 该 公司 成 员 必 须知 
道 密 钥 库 的 口令 ， 显 然 这 是 一 项 敏感 的 操作 。 

现在 Alice 将 文件 alice_signedby_acmeroot .cert 交 给 Cindy 和 ACME 软件 公司 的 
其 他 任何 人 。 或 者 ，ACME 软件 公司 直接 将 该 文件 存储 在 公司 的 目录 中 。 请 记 住 ， 该 文件 包 
含 了 Alice 的 公共 密 钥 和 ACME 软件 公司 的 声明 ， 证 明 该 密 钥 确实 属于 Alice. 

现在 ，Cindy 将 签名 的 证 书 导 入 到 她 的 密 钥 库 中 : 

keytool -importcert -keystore cindy.certs -alias alice -file alice_signedby_acmeroot. cer 

密 钥 库 要 进行 校 验 ， 以 确定 该 密 钥 是 由 密 钥 库 中 已 有 的 受信 任 的 根 密 钥 签 过 名 的 。Cindy 
就 不 必 对 证 书 的 指纹 进行 校 验 了 。 

— E Cindy 添加 了 根 证 书 和 经 常 给 她 发 送 文档 的 人 的 证 书后 ， 她 就 再 也 不 用 担心 密 钥 库 了 。 
9.4.6 证书 请 求 

在 前 一 节 中 ， 我 们 用 密 钥 库 和 CertificateSigner 工具 模拟 了 一 个 CA。 但 是 ， 大 多 


= 


if 


数 CA 都 运行 着 更 加 复杂 的 软件 来 管理 证 书 ， 并 且 使 用 的 证 书 格式 也 略 有 不 同 。 本 节 将 展示 
与 这 些 软件 包 进 行 交 互 时 需要 增加 的 处 理 步 又 。 

我 们 将 用 OpenSSL 软件 包 作 为 实例 。 许 多 Linux 系统 和 Mac OS X 都 预 装 了 这 个 软件 ， 
并 且 Cygwin 端口 也 可 用 这 个 软件 ， 你 也 可 以 到 http://www.openssl.org 网 站 下 载 。 

为 了 创建 一 个 CA， 需 要 运行 CA 脚本 ， 其 确切 位 置 依赖 于 你 的 操作 系统 。 在 Ubuntu 
上 ， 运行 

/usr/lib/ss]/misc/CA.pl -newca 

这 个 脚本 会 在 当前 目录 中 创建 一 个 demoCA 子 目 录 ， 这 个 目录 包含 了 一 个 根 密 钥 对 ， 并 
存储 了 证 书 与 证 书 撤销 列表 。 

你 希望 将 这 个 公共 密 钥 导入 到 所 有 雇员 的 Java 密 钥 库 中 ,但 是 它 的 格式 是 隐私 增强 型 邮件 
(PEM) 格式 ， 而 不 是 密 钥 库 更 容易 接受 的 DER 格式 。 将 文件 demoCA/cacert .pem 复制 成 文 
{F acmeroot .pem， 然 后 在 文本 编辑 器 中 打开 这 个 文件 。 移 除 下 面 这 行 之 前 的 所 有 内 容 : 


现在 可 以 按照 通常 的 方式 将 acmeroot .pem 导 人 到 每 个 密 钥 库 中 了 : 

keytool -importcert -keystore cindy.certs -alias alice -file acmeroot.pem 

这 看 起 来 有 点 不 可 思议 ，keytoo1 竟然 不 能 目 己 去 执行 这 种 编辑 操作 。 

要 对 Alice 的 公共 密 钥 签名 ， 需 要 生成 一 个 证 书 请 求 ， 它 包含 这 个 PEM 格式 的 证 书 : 

keytool] -certreq -keystore alice.store -alias alice -file alice.pem 

要 签名 这 个 证 书 ， 需 要 运行 : 

openssl ca -in alice.pem -out alice_signedby_acmeroot.pem 

与 前 面 一 样 ， 在 alice_signedby_acmeroot.pem 中 切除 BEGIN CERTIFICATE/END 
CERTIFICATE 标记 之 外 的 所 有 内 容 。 然 后 ， 将 其 导入 到 密 钥 库 中 : 

keytool -importcert -keystore cindy.certs -alias alice -file alice_signedby_acmeroot.pem 

你 可 以 使 用 相同 的 步 又， 使 一 个 证 书 得 到 诸如 VeriSign 这 样 的 公共 证 书 权 威 机 构 的 
签名 。 


947 ”代码 签名 


认证 技术 最 重要 的 一 个 应 用 是 对 可 执行 程序 进行 签名 。 如 果 从 网 上 下 载 一 个 程序 ， 目 然 
会 关心 该 程序 可 能 带 来 的 危害 ， 例 如 ， 该 程序 可 能 已 经 感染 了 病毒 。 如 果 知 道 代 码 从 何 而 
来 ， 并 且 它 从 离开 源头 后 就 没有 被 算 改 过 ， 那 么 放心 程度 会 比 不 清楚 这 些 信 息 时 要 高 得 多 。 

本 节 将 展示 如 何 对 TAR 文件 签名 ， 以 及 如 何 配 置 Java 以 校 验 这 种 签名 。 这 种 能 力 是 为 
Java 插件 而 设计 的 ， 即 它 是 为 启动 applet 和 Java Web Start 应 用 而 设计 的 。 这 些 技 术 已 经 不 
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再 被 广泛 使 用 了 ， 但 是 你 仍旧 需要 在 遗留 产品 中 支持 它们 。 

当 Java 首次 发 布 时 ，applet 在 加 载 之 后 就 运行 于 具有 有 限 权 限 的 “ 沙 盒 ”之 中 。 如 果 
用 户 想 要 使 用 可 以 访问 本 地 文件 系统 、 创 建 网 络 连接 等 诸如 此 类 功能 的 applet， 那 么 就 必须 
明确 同意 允许 其 运行 。 为 了 确保 applet 代码 不 会 在 传输 过 程 中 被 算 改 ， 必 须 对 其 进行 数字 
签名 。 

下 面 是 一 个 具体 例子 。 假 设 当 你 在 因特网 上 冲浪 时 ， 遇 到 了 一 个 Web wh, MARAE 
授予 了 需要 的 权限 ， 它 就 会 运行 一 个 来 自 不 明 提 供 商 的 applet (参见 图 9-14 )。 这 样 的 程序 是 
用 由 证 书 权 威 机 构 发 放 的 “软件 开发 者 ”证 书 进行 签名 的 。 弹 出 的 对 话 框 用 于 确定 软件 开发 
者 和 证 书 发 放 者 的 身份 。 现 在 ， 你 需要 决定 是 否 对 该 程序 授权 。 

那么 什么 样 的 因素 可 能 会 影响 你 的 决定 呢 ? 假设 下 面 是 你 已 经 了 解 的 情况 : 

1 ) Thawte 公司 将 一 个 证 书 卖 给 了 软件 开发 人 员 。 

2) 程序 确实 是 用 该 证 书签 名 的 ， 并 且 在 传输 过 程 中 没有 被 算 改 过 。 

3 ) 该 证 书 确实 是 由 Thawte 签名 的 ， 它 是 用 本 地 cacerts 文件 中 的 公共 密 钥 校 验 的 。 

这 是 否 就 意味 着 该 代码 可 以 安全 运行 了 ? 如 果 你 只 知道 供应 商 的 名 字 ， 以 及 Thawte 公 
司 卖 给 了 他 们 一 个 软件 开发 者 证 书 这 个 事实 ， 那 么 你 会 信赖 该 供应 商 吗 ? 如 果 想 要 担保 
ChemAxonkft. 不 是 个 彻头彻尾 的 破解 者 ， 念 怕 连 Thawte 公司 自己 也 会 陷入 麻烦 之 中 。 然 
而 ， 没 有 一 个 证 书 发 放 者 会 对 软件 供应 商 的 诚信 和 度 和 资格 能 力 进行 广泛 的 审查 。 它 们 通常 只 
会 通过 审查 工商 执照 或 护照 来 校 验 身份 。 






FF Warning - Security 

The application's digital signature has been 
verified. Do you want to run the 
application? 
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正如 你 所 见 ， 这 不 是 一 个 令 人 满意 的 解决 方案 。 更 好 的 方式 应 该 是 扩展 沙 盒 的 功能 。 当 
Java Web Start 技术 首次 发 布 时 ， 它 就 超越 了 沙 盒 ， 使 用 户 能 够 同意 授予 受 限 的 文件 和 打印 机 
访问 权限 。 但 是 ， 这 种 概念 从 来 都 没有 得 到 进一步 发 展 。 事 情 走向 了 相反 的 方向 。 当 沙 盒 受 
到 黑客 攻击 时 ，Oracle 发 现 跟 在 后 面 修补 漏洞 难以 实现 ， 因 此 停止 了 对 所 有 未 签名 applet 的 
支持 。 

当今 ，applet 已 经 很 不 常见 了 ， 并 且 几 乎 只 是 为 了 遗留 系统 而 使 用 它 。 如 果 你 想 要 支持 
服务 于 大 众 的 applet， 那 么 就 需要 用 Java 运行 时 环境 所 信任 的 提供 商 的 证 书 对 其 进行 签名 。 

对 内 联网 的 应 用 可 以 做 得 更 好 一 点 。 人 们 可 以 在 本 地 机 器 上 安装 策略 文件 和 证 书 ， 使 得 
在 启动 从 受信 源 而 来 的 代码 时 可 以 无 需 任 何 用 户 交 互 。 无 论 何 时 ， 只 要 Java 插件 工具 加 载 了 
签名 的 文档 ， 它 就 会 向 策略 文件 索要 权限 ， 并 向 密 钥 库 索要 签名 。 

在 本 节 的 剩余 部 分 ， 我们 将 要 介绍 如 何 建立 策略 文件 ， 来 为 已 知 来 源 的 代码 赋予 特定 的 
权限 。 创 建 和 部 署 这 些 策 略 文件 不 是 普通 最 终 用 户 要 做 的 ， 然 而 ， 系 统管 理 员 在 准备 部 署 企 
业内 联网 程序 时 需要 做 这 些 工作 。 

假设 ACME 软件 公司 想 让 它 的 用 户 运 行 某 些 需要 具备 本 地 文件 访问 权限 的 程序 ， 并 且 想 
要 通过 浏览 器 将 这 些 程序 部 署 为 applet 或 者 Web Start 应 用 。 

正如 在 本 章 前 面部 分 看 到 的 那样 ，ACME 可 以 根据 applet 的 代码 基 来 确定 它们 的 身份 ， 
但 是 那 将 意味 着 每 当 applet 代码 移动 到 不 同 的 Web 服务 器 时 ，ACME 都 需要 更 新 策略 文件 。 
为 此 ，ACME 决定 对 含有 程序 代码 的 JAR 文件 进行 签名 。 

首先 ，ACME 生成 根 证 书 : 

keytool -genkeypair -keystore acmesoft.certs -alias acmeroot 
当然 ,包含 私有 根 密 钥 的 密 钥 库 必须 存放 在 一 个 安全 的 地 方 。 因 此 ， 我 们 为 公共 证 书 建立 第 
二 个 密 钥 库 Client.certs， 并 将 公共 的 acmeroot 证 书 添加 进去 。 


keytool -exportcert -keystore acmesoft.certs -alias acmeroot -file acmeroot.cer 
keytool -importcert -keystore client.certs -alias acmeroot -file acmeroot.cer 


为 了 创建 一 个 经 过 签名 的 JAR 文件 ， 首 先 将 各 个 类 文件 添加 到 JAR 文件 中 ， 例 如 : 


javac FileReadApplet.java 
jar cvf FileReadApplet.jar *.class 


然后 ACME 中 某 个 受信 任 的 人 运行 jarsigner 工具 ， 指 定 JAR 文件 和 私有 密 钥 的 别名 : 
jarsigner -keystore acmesoft.certs FileReadApplet.jar acmeroot 
被 签名 的 applet 现在 就 已 经 准备 好 在 Web IRA ar Pe I o 
接着 ， 让 我 们 转 而 配置 客户 机 ， 必 须 将 一 个 策略 文件 发 布 到 每 一 台 客 户 机 上 。 
为 了 引用 密 钥 库 ， 策 略 文件 将 以 下 面 这 行 开头 : 
keystore "keystoreURL", "keystoreType’ ; 
其 中 ，URL 可 以 是 绝对 的 或 相对 的 ， 其 中 相对 URL 是 相对 于 策略 文件 的 位 置 而 言 的 。 如 果 
密 钥 库 是 由 keytoo1 工具 生成 的 ， 则 它 的 类 型 是 式 S。 例 如 : 
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keystore "client.certs", "JKS"; 
grant 子 句 可 以 有 signedBy “alias” JEZ., tn: 


grant signedBy "acmeroot" 


i 

所 有 可 以 用 与 别名 相关 联 的 公共 密 钥 进行 校 验 的 签名 代码 现在 都 已 经 在 grant 语句 中 被 
授予 了 权限 。 

可 以 用 程序 清单 9-17 中 的 applet 来 进行 上 面 的 代码 签名 过 程 。 该 applet 试图 读 取 一 
个 本 地 文件 ， 而 默认 的 安全 策略 只 允许 applet 读 取 它 的 代码 基 及 其 子 目 录 中 的 文件 。 用 
appletviewer 来 运行 该 applet， 然 后 检验 是 否 只 能 读 取 代码 基 目 录 中 的 文件 ， 而 不 能 读 取 
其 他 目录 下 的 文件 。 

现在 ,创建 一 个 包含 如 下 内 容 的 策略 文件 applet .policy: 

keystore "client.certs", "JKS"; 


grant signedBy "acmeroot" 


permission java.lang.RuntimePermission "usePolicy”; 
permission java.io.FilePermission "/etc/*", "read": 


usePolicy 权限 覆盖 了 作用 于 被 签名 的 applet 的 默认 的 “全 部 拥有 或 全 部 没有 ” 权 
限 。 这 里 ， 我 们 声明 任何 由 acmeroot 签名 的 applet 都 被 允许 读 取 /etc 目录 中 的 文件 。 
(Windows HF: 可 以 替换 为 其 他 诸如 C:\Windows 这 样 的 目录 。) 

最 后 ， 告 诉 applet 浏览 器 使 用 该 策略 文件 : 


appletviewer -J-Djava.security.policy=applet.policy FileReadApplet.html 


现在 该 applet 可 以 读 取 /etc 目录 中 的 所 有 文件 了 ， 这 证 明了 签名 机 制 发 挥 了 作用 。 


© 提示 : 如 果 你 在 执行 这 一 步 时 碰 上 了 问题 ， 那 么 请 添加 -J-Djava.security.debug= 

policy 选项 ， 这 样 你 就 能 够 得 到 程序 是 如 何 建立 安全 策略 的 详细 追踪 消息 了 。 

作为 最 后 一 项 测试 ， 你 可 以 在 浏览 器 中 运行 applet (参见 图 9-15 ) 。 这 需要 将 权限 文件 
和 密 钥 库 复制 到 Java 部 署 目 录 中 。 如 果 你 运行 的 是 UNIX 或 Linux， 这 个 目录 就 是 你 的 主 目 
录 下 的 .java/deployment 子 目录 下 。 在 Windows Vista 或 Windows 7 中， 这 个 目录 是 C: 
\Users\yourLoginName\AppData\Sun\Java\Deployment 目录 。 在 下 面 的 内 容 中 ， 我 们 
将 用 deploydir 来 引用 这 个 目录 。 

将 applet.policy 和 client.certs #@ Hl 8| deploydir/security 目录 中 。 在 这 个 
目录 中 ,将 applet.policy 重 命名 为 java.pol1icy。( 仔 细 检 查 你 是 否 覆 盖 了 已 有 的 java. 
policy 文件 ， 如 果 已 有 该 文件 ， 应 该 将 applet.policy 的 内 容 添 加 到 其 中 。) 


G 提示 : 更 多 有 关 配 置 客 户 端 Java 安全 的 细节 ， 可 以 参阅 http://docs.oracle.com/javase/8/ 
docs/technotes/guides/jweb.html 处 的 Java 富 互 联网 应 用 指南 。 
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Mozilla Firefox 
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图 9-15 ”经 过 签名 的 applet 可 以 读 取 本 地 文件 


重新 启动 浏览 器 ， 并 加 载 Fi1eReadApp1et .htm1 ， 你 应 该 不 会 再 看 到 提示 你 接受 某 类 
证 书 的 信息 。 检 查 你 是 否 能 够 加 载 /etc 目录 以 及 applet 被 加 载 的 目录 中 的 所 有 文件 ， 而 其 
他 目录 中 的 文件 都 不 能 加 载 。 

测试 完毕 后 ， 记 着 清理 dep1oydir/security 目录 ， 将 java.policy 和 client. 
certs 文件 移 除 。 重 启 浏览 器 ， 清 除 之 后 ， 如 果 再 次 加 载 该 applet， 你 将 无 法 再 从 本 地 文件 
系统 中 读 取 文件 ， 而 且 ， 你 会 看 到 关于 证 书 的 提示 。 我 们 将 在 下 一 节 讨 论 安全 证 书 。 





package signed; 


1 

2 

3 Import java.awt.*; 

4 import java.awt.event.*; 
5 import java.i0.*; 

6 import java.nio.file.*; 
7 import javax.swing.*; 

8 

9 


/[** 
10 * This applet can run “outside the sandbox" and read local files when it is given the right 
11 * permissions. 
12 * @version 1.13 2016-05-10 
13 * @author Cay Horstmann 
14 */ 
is public class FileReadApplet extends JApplet 
16 { 
17 private JTextField fileNameField; 
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18 private JTextArea fileText; 


20 public void initQ) 


21 { 

22 EventQueue.invokeLater(() -> 

23 { 

24 fileNameField = new JTextField(20); 

25 JPanel panel = new JPanel(); 

26 panel.add(new JLabel ("File name:")); 

27 pane] .add(fileNameField) ; 

28 JButton openButton = new JButton("Open"); 
29 panel .add(openButton) ; 

30 ActionListener listener = event -> loadFile(fileNameField.getText()); 
31 fileNameField.addActionListener(listener) ; 
32 openButton.addActionListener(listener) ; 

33 add(panel, "North"); 

34 fileText = new JTextArea(); 

35 add(new JScrol]Pane(fileText), "Center"); 
36 pi 

37 } 

38 

39 /** 

40 * Loads the contents of a file into the text area. 
41 * @param filename the file name 

42 */ 

43 public void loadFile(String filename) 

44 { 

45 fileText.setText(""); 

46 try 

47 { 

48 fileText.append(new String(Files.readAl]Bytes(Paths.get(filename)))): 
49 

50 catch (IOException ex) 

51 

52 fileText.append(ex + "\n"); 

53 } 

54 catch (SecurityException ex) 

55 

56 fileText.append("I am sorry, but I cannot do that.\n"); 
57 fileText.append(ex + "\n"); 

58 ex.printStackTrace() ; 

59 } 

60 } 

61 } 





95 ”加 密 


到 现在 为 止 ， 我 们 已 经 介绍 了 一 种 在 Java 安全 API 中 实现 的 重要 密码 技术 ， 即 通过 数字 
签名 进行 的 认证 。 安 全 性 的 第 二 个 重要 方面 是 加 密 。 当 信息 通过 认证 之 后 ， 该 信息 本 身 是 直 
日 可 见 的 。 数 字 签 名 只 不 过 负责 检验 信息 有 没有 被 算 改 过 。 相 比 之 下 ,信息 被 加 密 后 ， 是 不 
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可 见 的 ， 只 能 用 匹配 的 密 钥 进行 解密 。 

认证 对 于 代码 签名 已 足够 了 一 一 没 必要 将 代码 隐藏 起 来 。 但 是 ， 当 applet 或 者 应 用 程序 
传输 机 密 信息 时 ， 比 如 信用 卡号 码 和 其 他 个 人 数据 等 ， 就 有 必要 进行 加 密 了 。 

过 去 ， 由 于 专利 和 出 口 控制 的 原因 ， 许 多 公司 被 禁止 提供 高 强度 的 加 密 技 术 。 洗 运 的 
是 ， 现 在 对 加 密 技 术 的 出 口 控制 已 经 不 是 那么 严格 了 ， 某 些 重要 算法 的 专利 也 已 到 期 。 现 
Æ, Java SE 已 经 有 了 出 色 的 加 密 支 持 ， 它 已 经 成 为 标准 类 库 的 一 部 分 。 


9.5.1 对 称 密码 


“Java 密码 扩展 ”包含 了 一 个 Cipher 类 ， 该 类 是 所 有 加 密 算 法 的 超 类 。 通 过 调用 下 面 
的 getInstance 方法 可 以 获得 一 个 密码 对 象 : 

Cipher cipher = Cipher.getInstance(algorithName) ; 

或 者 调用 下 面 这 个 方法 : 

Cipher cipher = Cipher.getInstance(algorithName, providerName) ; 

IDK 中 是 由 名 为 “SunJCE” 的 提供 商 提 供 密 码 的 ， 如 果 没 有 指定 其 他 提供 商 ， 则 会 默 
认为 该 提供 商 。 如 果 要 使 用 特定 的 算法 ， 而 对 该 算法 Oracle 公司 没有 提供 支持 ， 那 么 也 可 以 
指定 其 他 的 提供 商 。 

算法 名 称 是 一 个 字符 串 ， 比 如 “AES” 或 者 “DES/CBC/PKCS5Padding” 。 

DES， 即 数据 加 密 标准 ， 是 一 个 密 钥 长 度 为 56 位 的 古老 的 分 组 密码 。DES 加 密 算法 在 
现在 看 来 已 经 是 过 时 了 ， 因 为 可 以 用 穷 举 法 将 它 破 译 (参见 该 网 页 中 的 例子 : http://w2. 
eff.org/ Privacy/Crypto/Crypto_misc/DESCracker/)。 更 好 的 选择 是 采用 它 的 后 续 
版 本 ， 即 高 级 加 密 标准 (AES)， 更 多 详细 信息 ， 请 访问 网 址 http://www.csrc.nist.gov/ 
publications/fips/fips197/fips-197.pdf。 我 们 在 示例 中 使 用 了 AES. 

一 旦 获得 了 一 个 密码 对 象 ， 就 可 以 通过 设置 模式 和 密 钥 来 对 它 初始 化 。 


int mode=...; 
Key key = ，，,; 
cipher.init(mode, key); 


模式 有 以 下 几 种 : 


Cipher. ENCRYPT_MODE 
Cipher. DECRYPT_MODE 
Cipher. WRAP_MODE 
Cipher. UNWRAP_MODE 


wrap 和 unwrap 模式 会 用 一 个 密 钥 对 男 一 个 密 钥 进 行 加 密 ， 具 体例 子 请 参见 下 一 节 。 
现在 可 以 反复 调用 update 方法 来 对 数据 块 进行 加 密 。 

int blockSize = cipher. getBlockSize() ; 

byte[] inBytes = new byte[blockSize] ; 

. . . // read inBytes 


int outputSize= cipher. getOutputSize(block$ize) ; 
byte[] outBytes = new byte[outputSize] ; 
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int outLength = cipher.update(inBytes, 0, outputSize, outBytes) ; 
. . . // write outBytes 


完成 上 述 操作 后 ， 还 必须 调用 一 次 doFinal 方法 。 如 果 还 有 最 后 一 个 输入 数据 块 (其 字 
节 数 小 于 blockSize)， 那 么 就 要 调用 : 

outBytes = Cipher,doFinal (inBytes, 0, inLength); 

如 采 所 有 的 输入 数据 都 已 经 加 密 ， 则 用 下 面 的 方法 调用 来 代替 : 

outBytes = cipher.doFinal (); 

对 doFinal 的 调用 是 必需 的 ， 因 为 它 会 对 最 后 的 块 进行 “填充 ”。 就 拿 DES 密码 来 说 ， 
它 的 数据 块 的 大 小 是 8 字 节 。 假 设 输入 数据 的 最 后 一 个 数据 块 少 于 8 字 节 ， 当 然 我 们 可 以 将 
其 余 的 字 节 全 部 用 0 填充 ， 从 而 得 到 一 个 8 字 节 的 最 终 数据 块 ， 然 后 对 它 进行 加 密 。 但 是 ， 
当 对 数据 块 进行 解密 时 ， 数 据 块 的 结尾 会 附加 若干 个 0 字 节 ， 因 此 它 与 原始 输入 文件 之 间 会 
略 有 不 同 。 这 肯定 是 个 问题 ， 我 们 需要 一 个 填充 方案 来 避免 这 个 问题 。 常 用 的 填充 方案 是 
RSA Security 公司 在 公共 密 钥 密码 标准 # 5 中 (Public Key Cryptography Standard, PKCS) 描 
述 的 方案 (该 方案 的 网 址 为 https:/Vtods .ietf.org/htm1/rfc2898) 。 

在 该 方案 中 ， 最 后 一 个 数据 块 不 是 全 部 用 填充 值 0 进行 填充 ， 而 是 用 等 于 填充 字 节 数量 
的 值 作为 填充 值 进 行 填充 。 换 句 话 说 ， 如 果 工 是 最 后 一 个 (不 完整 的 ) 数据 块 ， 那 么 它 将 按 
如 下 方式 进行 填充 : 


L 01 if length(L) = 7 
L 02 02 if length(L) = 6 
L 03 03 03 if length(L) = 5 
L 07 07 07 07 07 07 07 if Tength(L) = 1 


最 后 ， 如 果 输 入 的 数据 长 度 确实 能 被 8 整除 ， 那 么 就 会 将 下 面 这 个 数据 块 : 


08 08 08 08 08 08 08 08 
附加 到 数据 块 后 ， 并 进行 加 密 。 在 解密 时 ， 明 文 的 最 后 一 个 字 节 就 是 要 丢弃 的 填充 字符 数 。 


9.5.2 EHER 


为 了 加 密 ， 我 们 需要 生成 密 钥 。 每 个 密码 都 有 不 同 的 用 于 密 钥 的 格式 ， 我 们 需要 确保 密 
钥 的 生成 是 随机 的 。 这 需要 遵循 下 面 的 步骤 : 

1) 为 加 密 算 法 获取 KeyGenerator 。 

2) 用 随机 源 来 初始 化 密 钥 发 生 器 。 如 果 密 码 块 的 长 度 是 可 变 的 ， 还 需要 指定 期 望 的 密 
码 块 长 度 。 

3 ) 调用 generateKey 方法 。 

例如 ， 下 面 是 如 何 生成 AES 密 钥 的 方法 : 


KeyGenerator keygen = KeyGenerator.getInstance("AES") ; 
SecureRandom random = new SecureRandom(); // see below 
keygen.init(random) ; 

Key key = keygen.generateKey(); 
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或 者 ， 可 以 从 一 组 固定 的 原生 数据 (也 许 是 由 口令 或 者 随机 击 键 产 生 的 ) 中 生成 一 个 密 
钥 ， 这 时 可 以 使 用 如 下 的 SecretKeyFactory: 


byte[] keyData = . . .; // 16 bytes for AES 
Secretkey key = new SecretKeySpec(keyData, "AES"); 


如 果 要 生成 密 钥 ， 必 须 使 用 “真正 的 随机 ” 数 。 例 如 ， 在 Random 类 中 的 常规 的 随机 数 发 
生 器 。 是 根据 当前 的 日 期 和 时 间 来 产生 随机 数 的 ， 因 此 它 不 够 随机 。 假 设计 算 机 时 钟 可 以 精确 
到 1/10 秒 ， 那 么 ， 每 天 最 多 存在 864 000 个 种 子 。 如 果 攻 击 者 知道 发 布 密 钥 的 日 期 (通常 可 以 
由 消息 日 期 或 证 书 有 效 日 期 推算 出 来 )， 那 么 就 可 以 很 容易 地 生成 那 一 天 所 有 可 能 的 种 子 。 

SecureRandom 类 产生 的 随机 数 ， 远 比 由 Random 类 产生 的 那些 数字 安全 得 多 。 你 仍然 
需要 提供 一 个 种 子 ， 以 便 在 一 个 随机 点 上 开始 生成 数字 序列 。 要 这 样 做， 最 好 的 方法 是 从 一 
个 诸如 白 噪声 发 生 器 之 类 的 硬件 设备 那里 获取 输入 。 另 一 个 合理 的 随机 输入 源 是 请 用 户 在 键 
盘 上 进行 随心 所 欲 的 育 打 ， 但 是 每 次 融 击 键盘 只 为 随机 种 子 提 供 1 位 或 者 2 位 。 一 旦 你 在 字 
节 数 组 中 收集 到 这 种 随机 位 后 ， 就 可 以 将 它 传递 给 setSeed 方法 。 


SecureRandom secrand = new SecureRandom() ; 
byte[] b = new byte[20] ; 

// fill with truly random bits 

secrand. setSeed(b) ; 


如 果 没 有 为 随机 数 发 生 器 提供 种 子 ， 那 么 它 将 通过 启动 线程 ， 使 它们 睡眠 ， 然 后 测量 它 
们 被 唤醒 的 准确 时 间 ， 以 此 来 计算 自己 的 20 个 字 节 的 种 子 。 
注意 : 这 个 算法 仍然 未 被 认为 是 安全 的 。 而 有 全 ， 在 过 去 ， 依 靠 对 诸如 硬盘 访问 时 间 之 类 

的 其 他 的 计算 机 组 件 进 行 计 时 的 算法 ， 后 来 也 被 证 明 并 不 是 完全 随机 的 。 

本 节 结 尾 处 的 示例 程序 将 应 用 AES 密码 (参见 程序 清单 9-18 )。 程 序 清单 9-19 中 的 Crpt 
工具 方法 将 会 在 其 他 示例 中 被 复 用 。 如 果 要 使 用 该 程序 ， 首 先 要 生成 一 个 密 钥 ， 运 行 如 下 命 
令 行 : 

密 钥 就 被 保存 在 secret .key 文件 中 了 。 

java aes.AESTest -genkey secret.key 

现在 可 以 用 如 下 命令 进行 加 密 : 

java aes.AESTest -encrypt plaintextFile encryptedFile secret.key 

用 如 下 命令 进行 解密 : 

java aes.AESTest -decrypt encryptedFile decryptedFile secret. key 

该 程序 非常 直观 。 使 用 -genkey 选项 将 产生 一 个 新 的 密 钥 ， 并 且 将 其 序列 化 到 给 定 
的 文件 中 。 该 操作 需要 花费 较 长 的 时 间 ， 因 为 密 钥 随机 生成 器 的 初始 化 非常 耗费 时 间 。- 
encrypt 和 -decrypt 选项 都 调用 相同 的 crypt 方法 ， 而 crypt 方法 会 调用 密码 的 update 
和 doFinal 方法 。 请 注意 update 方法 和 doFinal 方法 是 怎样 被 调用 的 ， 只 要 输入 数据 块 
具有 全 长 度 (长 度 能 够 被 8 整除 )， 就 要 调用 update 方法 ， 而 如 果 输 入 数据 块 不 具有 全 长 度 
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(长 度 不 能 被 8 整除 ， 此 时 需要 填充 )， 或 者 没有 更 多 额外 的 数据 (以 便 生成 一 个 填充 字 节 )， 
那么 sails doFinal 方法 。 





oo oo N en A wu N p 


10 


package aes; 


import java.io. *; 
import java.security.*; 
import javax.crypto.*; 


[** 
* This program tests the AES cipher. Usage:<br> 
* java aes. AESTest -genkey keyfile<br> 
* java aes.AESTest -encrypt plaintext encrypted keyfile<br> 
* java aes.AESTest -decrypt encrypted decrypted keyfile<br> 
* @author Cay Horstmann 
* @ersion 1.01 2012-06-10 
*/ 
public class AESTest 
{ 


public static void main(String[] args) 
throws IOException, GeneralSecurityException, ClassNotFoundException 


{ 
if (args [0] .equals("-genkey")) 
{ 


KeyGenerator keygen = KeyGenerator.getInstance("AES") ; 

SecureRandom random = new SecureRandom(); 

keygen. init (random) ; 

Secretkey key = keygen.generateKey(); 

try (ObjectOutputStream out = new ObjectOutputStream(new Fi leQutputStream(args[1]))) 
{ 


out.writeObject (key) ; 


} 

else 

{ 
int mode; 
if (args[0].equals("-encrypt")) mode = Cipher. ENCRYPT MODE; 
else mode = Cipher.DECRYPT_MODE; 


try (ObjectInputStream keyIn = new ObjectInputStream(new Fi leInputStream(args[3])); 
InputStream in = new FileInputStream(args[1]); 
OutputStream out = new FileQutputStream(args[2])) 


Key key = (Key) keyIn.readObject(); 

Cipher cipher = Cipher.getInstance("AES") ; 
Cipher.init(mode, key); 

Util.crypt(in, out, cipher); 
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package aes; 


import java.io.*; 
import java,security.*; 
import javax.crypto.*; 


public class Util 
{ 
/** 
* Uses a cipher to transform the bytes in an input stream and sends the transformed bytes to 
* an output stream. 
* @param in the input stream 
* @param out the output stream 
* @param cipher the cipher that transforms the bytes 
* 
/ 
public static void crypt(InputStream in, OutputStream out, Cipher cipher) 
throws IOException, General SecurityException 
{ 


int blockSize = cipher. getBlockSize() ; 

int outputSize = cipher. getOutputSize(blockSize) ; 
byte[] inBytes = new byte[blockSize] ; 

byte[] outBytes = new byte[outputSize] ; 


int inLength = 0; 
boolean more = true; 
while (more) 
{ 
inLength = in.read(inBytes) ; 
if (inLength == blockSize) 
{ 
int outLength = cipher.update(inBytes, 0, blockSize, outBytes) ; 
out.write(outBytes, 0, outLength) ; 
} 
else more = false; 
} 
if (inLength > 0) outBytes = cipher.doFinal(inBytes, 0, inLength) ; 
else outBytes = cipher.doFinal (); 
out.write(outBytes) ; 






static Cipher getInstance(String algorithmName ) 
static Cipher getInstance(String algorithmName, String providerName ) 
返回 实现 了 指定 加 密 算法 的 Cipher 对 象 。 如 果 未 提供 该 算法 ， 则 抛 出 一 个 
NoSuchAlgorithmException 异常 。 

int getBlockSize() 


返回 密码 块 的 大 小 ， 如 果 该 密码 不 是 一 个 分 组 密码 ， 则 返回 0。 
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èe int getOutputSize(int inputLength) 
如 采 下 一 个 输入 数据 块 拥有 给 定 的 字 节 数 ， 则 返回 所 需 的 输出 缓冲 区 的 大 小 。 本 方法 
的 运行 要 考虑 到 密码 对 象 中 所 有 已 缓冲 的 字 节 数量 。 

evoid init(int mode, Key key) 
对 加 密 算法 对 象 进行 初始 化 。Mode 是 ENCRYPT_MODE, DECRYPT_MODE, WRAP_MODE, 
或 者 UNWRAP_MODE 之 一 。 

e byte[] update(byte[] in) 

ebyte[] update(byte[] in, int offset, int length) 

e int update(byte[] in, int offset, int length, byte[] out) 
对 输入 数据 块 进行 转换 。 前 两 个 方法 返回 输出 ， 第 三 个 方法 返回 放 入 out 的 字 节 数 。 

ebyte[] doFinal() 

e byte[] doFinal(byte[] in) 

ebyte[] doFinal(byte[] in, int offset, int length) 

® int doFinal(byte[] in, int offset, int length, byte[] out) 
转换 输入 的 最 后 一 个 数据 块 ， 并 刷新 该 加 密 算法 对 象 的 缓冲 。 前 三 个 方法 返回 输出 ， 
第 四 个 方法 返回 放 入 out 的 字 节 数 。 





e static KeyGenerator getInstance(String algorithmName) 


返回 实现 指定 加 密 算法 的 KeyGenerator 对 象 。 如 果 未 提供 该 加 密 算法 ， 则 抛 出 一 个 
NoSuchA1gorithmException 异常 。 


evoid init(SecureRandom random) 
e void init(int keySize, SecureRandom random) 


对 密 钥 生 成 器 进行 初始 化 。 


e SecretKey generateKey() 


生成 一 个 新 的 密 钥 。 





e SecretKeySpec(byte[] key, String algorithmName) 
创建 一 个 密 钥 描述 规格 说 明 。 


9.5.3 ”密码 流 


JCE 库 提 供 了 一 组 使 用 便捷 的 流 类 ， 用 于 对 流 数据 进行 自动 加 密 或 解密 。 例 如 ， 下 面 是 
对 文件 数据 进行 加 密 的 方法 : 


Cipher cipher=.. .; 
Cipher.init(Cipher.ENCRYPT_MODE, key); 
CipherOutputStream out = new CipherOutputStream(new FileQutputStream(outputFileName), cipher); 
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byte[] bytes = new byte[BLOCKSIZE] ; 
int inLength = getData(bytes); // get data from data source 
while (inLength != -1) 


out.write(bytes, 0, inLength) ; 
inLength = getData(bytes); // get more data from data source 


} 
out. flush; 


同样 地 ， 可 以 使 用 CipherInputStream， 对 文件 的 数据 进行 读 取 和 解密 : 


Cipher cipher =.. .; 
cipher,init(Cipher.DECRYPT_MODE, key) ; 
CipherInputStream in = new CipherInputStream(new FileInputStream(inputFileName) , cipher); 
byte[] bytes = new byte[BLOCKSIZE] ; 
int inLength = in.read(bytes) ; 
while (inLength != -1) 
{ 
putData(bytes, inLength); // put data to destination 
inLength = in. read(bytes) ; 


} 
密码 流 类 能 够 透明 地 调用 update 和 doFinal 方法 ， 所 以 非常 方便 。 
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e CipherInputStream(InputStream in, Cipher cipher) 

构建 一 个 输入 流 ， 以 读 取 in 中 的 数据 ， 并 且 使 用 指定 的 密码 对 数据 进行 解密 和 加 密 。 
eint read() 
eint read(byte[] b, int off, int len) 

读 取 输 入 流 中 的 数据 ， 该 数据 会 被 自动 解密 和 加 密 。 










e CipherOutputStream(OutputStream out, Cipher cipher ) 
构建 一 个 输出 流 ， 以 便 将 数据 写 人 out ， 并 且 使 用 指定 的 密码 对 数据 进行 加 密 和 解密 。 
e void write(int ch) 
e void write(byte[] b, int off, int len) 
将 数据 写 入 输出 流 ， 该 数据 会 被 自动 加 密 和 解密 。 
e void flush() 
刷新 密码 缓冲 区 ， 如 果 需 要 的 话 ， 执 行 填充 操作 。 


95.4 公共 密 钥 密 码 


在 前 面 的 小 节 中 看 到 的 AES 密码 是 一 种 对 称 密码 ， 加 密 和 解密 都 使 用 相同 的 密 钥 。 对 
称 密 码 的 致命 缺点 在 于 密码 的 分 发 。 如 果 Alice 给 Bob 发 送 了 一 个 加 密 的 方法 ， 那 么 Bob 需 
要 使 用 与 Alice 相同 的 密 钥 。 如 果 Alice 修改 了 密 钥 ， 那 么 她 必须 在 给 Bob 发 送信 息 的 同时 ， 
还 要 通过 安全 信道 发 送 新 的 密 钥 ， 但 是 也 许 她 并 没有 到 达 Bob 的 安全 信道 ， 这 也 正 是 她 必须 
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对 她 发 送 给 Bob 的 信息 进行 加 密 的 原因 。 

公共 密 钥 密码 技术 解决 了 这 个 问题 。 在 公共 密 钥 密 码 中 ，Bob 拥有 一 个 密 钥 对 ， 包 括 一 
个 公共 密 钥 和 一 个 相 匹 配 的 私有 密 钥 。Bob 可 以 在 任何 地 方 发 布 公共 密 钥 ， 但 是 他 必须 严格 
保守 他 的 私有 和 密 钥 。Alice 只 需要 使 用 公共 密 钥 对 她 发 送 给 Bob 的 信息 进行 加 密 即 可 。 

实际 上 ， 加 密 过 程 并 没有 那么 简单 。 所 有 已 知 的 公共 密 钥 算法 的 操作 速度 都 比 对 称 密 钥 
算法 (比如 DES 或 AES 等 ) 慢 得 多 ,使 用 公共 密 钥 算法 对 大 量 的 信息 进行 加 密 是 不 切实 际 
的 。 但 是 ， 如 果 像 下 面 这 样 ， 将 公共 密 钥 密 码 与 快速 的 对 称 密码 结合 起 来 ， 这 个 问题 就 可 以 
得 到 解决 : 

1 ) Alice 生成 一 个 随机 对 称 加 密 密 钥 ， 她 用 该 密 钥 对 明文 进行 加 密 。 

2) Alice 用 Bob 的 公共 密 钥 给 对 称 密 钥 进行 加 密 。 

3 ) Alice 将 加 密 后 的 对 称 密 钥 和 加 密 后 的 明文 同时 发 送 给 Bob。 

4 ) Bob 用 他 的 私有 密 钥 给 对 称 密 钥 解密 。 

5 ) Bob 用 解密 后 的 对 称 密 钥 给 信息 解密 。 

除了 Bob 之 外 ， 其 他 人 无 法 给 对 称 密 钥 进 行 解密 ， 因 为 只 有 Bob 拥有 解密 的 私有 密 钥 。 
这 样 ， 昂 贵 的 公共 密 钥 加 密 技术 就 可 以 只 应 用 于 少量 的 关键 数据 的 加 密 。 

最 常见 的 公共 密 钥 算法 是 Rivest, Shamir 和 Adleman 发 明 的 RSA 算法 。 直 到 2000 年 10 
月 ， 该 算法 一 直 受 RSA Security 公司 授予 的 专利 保护 。 该 专利 的 转让 许可 证 价格 昂贵 ， 通 常 
要 支付 3% 的 专利 权 使 用 费 ， 每 年 至 少 付款 50 000 美元 。 现 在 该 加 密 算法 已 经 公开 。 

如 果 要 使 用 RSA 算法 ， 就 需要 一 对 公共 /私有 密 钥 。 你 可 以 按 如 下 方法 使 用 Key- 
PairGenerator 来 获得 . 


KeyPairGenerator pairgen = KeyPairGenerator.getInstance("RSA") ; 
SecureRandom random = new SecureRandom() ; 
pairgen.initialize(KEYSIZE, random) ; 

KeyPair keyPair = pairgen.generateKeyPair(); 

Key publicKey = keyPair.getPublic(); 

Key privateKey = keyPair.getPrivate(); 


程序 清单 9-20 中 的 程序 有 三 个 选项 。-genkey 选项 用 于 产生 一 个 密 钥 对 ，-encrypt 选 
项 用 于 生成 AES 密 钥 ， 并 且 用 公共 密 钥 对 其 进行 包装 。 


Key key =. . .; // an AES key 

Key publickey = . . .; // a public RSA key 
Cipher cipher = Cipher.getInstance("RSA") ; 
cipher.init(Cipher.WRAP_MODE, publicKey); 
byte[] wrappedKey = cipher.wrap(key) ; 


然后 它 会 生成 一 个 包含 下 列 内 容 的 文件 : 

o 包装 过 的 密 钥 的 长 度 。 

e 包装 过 的 密 钥 字 节 。 

e 用 AES 密 钥 加 密 的 明文 。 

-decrypt 选项 用 于 对 这 样 的 文件 进行 解密 。 请 试 运行 该 程序 ， 首 先生 成 RSA 密 钥 : 


java rsa.RSATest -genkey public.key private, key 
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然后 对 一 个 文件 进行 加 密 : 
java rsa.RSATest -encrypt plaintextFile encryptedFile public. key 
最 后 ， 对 该 文件 进行 解密 ， 并 且 检 验 解密 后 的 文件 是 否 与 明文 相 匹配 : 


java rsa.RSATest -decrypt encryptedFile decryptedFile private,key 





package rsa; 


1 

2 

3 import java.io.*; 

4 import java.security.*; 
5 import javax.crypto.*; 
6 

7 

8 

9 


j** 

* This program tests the RSA cipher. Usage:<br> 

* java rsa.RSATest -genkey public private<br> 
10 * java rsa.RSATest -encrypt plaintext encrypted public<br> 
11 * java rsa.RSATest -decrypt encrypted decrypted private<br> 
12 * @author Cay Horstmann 
13 * @ersion 1.01 2012-06-10 
14 */ 
15 public class RSATest 
16 { 
ı7 private static final int KEYSIZE = 512; 


19 public static void main(String[] args) 


20 throws IOException, General SecurityException, ClassNotFoundException 

21 { 

22 if (args [0] .equals("-genkey")) 

23 { 

24 KeyPairGenerator pairgen = KeyPairGenerator.getInstance("RSA") ; 

25 SecureRandom random = new SecureRandom() ; 

26 pairgen.initialize(KEYSIZE, random) ; 

27 KeyPair keyPair = pairgen.generateKeyPair() ; 

28 try (ObjectOutputStream out = new ObjectOutputStream(new FileQutputStream(args[1]))) 
29 { 

30 out .writeObject(keyPair.getPublic()); 

31 

32 try (ObjectOutputStream out = new ObjectOutputStream(new FileQutputStream(args[2]))) 
33 

34 out.writeObject (keyPair.getPrivate()); 

35 } 

36 } 

37 else if (args[0].equals("-encrypt")) 

38 { 

39 KeyGenerator keygen = KeyGenerator.getInstance("AES"); 

40 SecureRandom random = new SecureRandom() ; 

41 keygen. init (random) ; 

42 SecretKey key = keygen.generateKey() ; 

43 

44 // wrap with RSA public key 

45 try (ObjectInputStream keyIn = new ObjectInputStream(new FileInputStream(args[3])); 





1 
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46 DataQutputStream out = new DataQutputStream(new FileQutputStream(args[2])); 
47 InputStream in = new FileInputStream(args[1]) ) 

48 

49 Key publicKey = (Key) keyIn. readObject(); 

50 Cipher cipher = Cipher.getInstance("RSA") ; 

51 cipher.init(Cipher.WRAP_MODE, publickey); 

52 byte[] wrappedKey = cipher.wrap(key) ; 

53 out.writeInt (wrappedKey. length) ; 

54 out.write(wrappedKey) ; 

55 

56 cipher = Cipher.getInstance("AES"); 

57 cipher.init(Cipher.ENCRYPT_MODE, key); 

58 Util.crypt(in, out, cipher); 

59 } 

60 } 

61 else 

62 

63 try (DataInputStream in = new DataInputStream(new FileInputStream(args[1])); 
64 ObjectInputStream keyIn = new ObjectInputStream(new FileInputStream(args[3])); 
65 OutputStream out = new FileQutputStream(args([2])) 

66 { 

67 int length = in. readInt(); 

68 byte[] wrappedkey = new byte[length]; 

69 in. read(wrappedKey, 0, length); 

70 

71 // unwrap with RSA private key 

72 Key privateKey = (Key) keyIn.readObject(); 

73 

74 Cipher cipher = Cipher.getInstance("RSA"); 

75 cipher.init(Cipher.UNWRAP_MODE, privateKey) ; 

76 Key key = cipher.unwrap(wrappedKey, "AES", Cipher. SECRET_KEY); 
77 

78 cipher = Cipher.getInstance("AES"); 

79 cipher.init(Cipher.DECRYPT_MODE, key); 

80 

81 Util.crypt(in, out, cipher); 

82 } 

83 } 

84 } 

85 } 





你 现在 已 经 看 到 了 Java 安全 模型 是 如 何 允 许 我 们 去 控制 代码 的 执行 的 ， 这 是 Java 平 台 
的 一 个 独一无二 且 越 来 越 重 要 的 方面 。 你 也 已 经 看 到 了 Java 类 库 提供 的 认证 和 加 密 服 务 。 但 
是 我 们 没有 涉及 许多 高 级 和 专门 的 话题 ， 比 如 : 
o 提供 了 对 Kerberos 协议 进行 支持 的 “通用 安全 服务 ”的 GSS-API (原则 上 同样 支持 
其 他 安全 信息 交换 协议 )。 下 面 这 个 网 址 上 有 一 份 指南 http://docs.oracle.com/ 
javase/7/docs/technotes/guides/security/jgss/tutorials, 
e 对 SASL 的 文 持 ，SASL 即 简单 认证 和 安全 层 ， 可 以 为 LDAP 和 IMAP 协议 所 使 用 。 如 
末 想 在 自己 的 应 用 程序 中 实现 SASL， 请 浏览 下 面 这 个 网 址 : http://docs.oracle. 


com/javase/7/docs/technotes/guides/security/sasl/sasl-refguide. 





html, _— 

o 对 SSL 的 支持 ，SSL 即 安全 套 接 层 。 在 HTTP 上 使 用 SSL 对 应 用 程序 的 编程 人 员 是 
透明 的 ， 只 需要 直接 使 用 以 https 开头 的 URL 即 可 。 如 果 想 要 给 你 的 应 用 程序 添加 
SSL 支持 ， 请 参阅 下 面 网 址 中 的 JSSE (Java 安全 套 接 扩展 ) 参考 指南 http://java. 
sun.com/ javase/6/docs/technotes/guides/security/jsse/JSSERefGuide. 
html, 

下 一 章 我 们 将 深入 讨论 高 级 Swing 编程 。 
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A 列表 A 文本 构件 
A 表格 A 进度 指示 器 
A 树 A 构件 组 织 器 与 装饰 器 


在 本 章 中 ， 我 们 继续 对 卷 I 的 Swing 用 户 界面 工具 包 进 行 讨论 。Swing 是 功能 丰富 的 工 
具 包 ， 而 本 书卷 仅仅 涉及 了 铬 干 简单 而 常用 的 构件 。 所 以 本 章 的 大 部 分 内 容 ， 将 研究 余下 
三 个 最 为 丰富 复杂 的 构件 : 列表 、 树 和 表格 。 然 后 我 们 转向 文本 构件 ， 讨 论 那 些 超越 卷 [ 中 
看 到 的 简单 的 文本 框 和 文本 域 的 特性 ， 我 们 将 展示 如 何在 文本 框 上 添加 校 验 和 微调 框 ， 以 及 
如 何 显示 诸如 HTML 这 样 的 结构 化 文本 。 接 下 来 ， 你 还 将 会 看 到 大 量 用 于 显示 耗 时 行为 的 进 
度 的 构件 。 在 本 章 的 最 后 ， 我 们 将 介绍 一 些 构件 组 织 器 ， 比 如 标签 面板 和 带 有 内 部 框架 的 桌 
面 面 板 。 


10.1 列表 


如 采 你 想 加 用 户 提供 一 个 选项 集 ， 而 单 选 按钮 或 复 选 框 又 显得 占用 了 太 多 的 空间 ， 那 么 
就 可 以 使 用 组 合 框 或 列表 。 组 合 框 相对 简单 ， 已 经 在 卷 I 中 介绍 过 。JList 构件 的 功能 更 加 
丰厚 ， 而 且 它 的 设计 与 树 形 构件 和 表格 构件 都 很 相似 。 所 以 ， 对 于 复杂 Swing 构件 的 讨论 ， 
我 们 将 从 ULi st 开始 。 

当然 ， 你 可 以 使 用 字符 串 列 表 ， 但 也 可 以 使 用 任意 对 象 的 列表 ， 你 可 以 完全 控制 它们 的 
外 在 显示 形式 。 正 是 列表 控件 的 这 种 内 部 结构 ， 使 它 不 仅 具备 极 强 的 通用 性 ， 而 且 也 更 精 
巧 。 遗 憾 的 是 ，Sun 公司 的 设计 人 员 认 为 他 们 更 应 该 炫耀 这 种 精巧 ， 而 不 是 将 它 对 那些 只 是 
想 使 用 这 些 构件 的 程序 员 隐 藏 起 来 。 大 家 很 快 就 会 发 现 ， 在 通常 情况 下 ， 这 种 列表 控制 有 点 
不 太 灵 活 ， 因 为 你 需要 操作 某 些 使 其 在 通常 情况 下 可 用 
的 复杂 机 制 。 我 们 先 介绍 最 简单 、 最 常用 的 情况 ， 即 字 
符 串 列表 框 ， 然 后 给 出 一 个 更 复杂 的 例子 来 展示 列表 构 
件 的 灵活 性 。 


10.1.1 JList 构件 


JList 可 以 将 多 个 选项 放置 在 单个 框 中 ， 图 10-1 是 
一 个 大 家 公认 的 不 合理 的 例子 。 用 户 可 以 选择 狐狸 的 属 
PE, EAN “quick KHER). “brown RERI, “hungry 图 10-1 一 个 列表 框 
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(饥饿 的 六、 “wild BFE AY)’, WRF “static RASH)”. “private AA Hy)” Al “final 
(最 终 的 ) 。 结 果 ， 你 可 以 让 这 只 private 的 static AY. final 的 狐狸 从 那 只 懒 狗 身 上 跳 过 去 了 。 

从 Java SE 7 开始 ，JList 是 一 个 泛 型 ， 其 type 参数 是 用 户 可 选 的 值 的 类 型 ; 在 本 例 中 ， 
是 JList<String>。 

为 了 构建 这 个 列表 框 ， 首 先 需 要 创建 一 个 字符 串 数组 ， 然 后 将 这 个 数组 传递 给 UList 构 
IEA o 

String[] words= { "quick", "brown", "hungry", "wild", .. . }; 

JList<String> wordlist = new JList<>(words) ; 


列表 框 不 能 自动 滚动 ， 要 想 为 列表 框 加 上 滚动 条 ， 必 须 将 它 插 人 到 一 个 滚动 面板 中 : 
JScrol]Pane scrol]Pane = new JScrol]Pane(wordList) ; 


然后 应 该 把 滚动 面板 而 不 是 列表 框 ， 插 入 到 外 围 面板 上 。 
我 们 必须 承认 ， 从 理论 上 讲 ， 把 列表 框 的 显示 和 滚动 机 制 隔离 开 来 是 优雅 的 设计 ， 但 是 
在 实际 应 用 中 却 令 人 苦 不 堪 言 ， 其 实 我 们 遇 到 的 所 有 列表 框 基本 上 都 需要 滚动 功能 。 强 制程 
序 员 在 默认 情况 下 每 次 都 去 作 这 种 麻烦 事 ， 以 使 他 们 赞赏 这 种 优雅 设计 ， 确实 有 点 粗暴 。 
默认 情况 下 ， 列 表 框 构件 可 以 显示 8 个 选项 ; 可 以 使 用 setVisibleRowCount 方法 改 
变 这 个 值 : 
wordList.setVisibleRowCount(4); // display 4 items 
还 可 以 使 用 以 下 三 个 值 中 的 任意 一 个 来 设置 列表 框 摆 放 的 方 问 : 
e JList. VERTICAL (默认 值 ): 垂直 摆 放 所 有 选项 。 
e JList .VERTICAL_WRAP : 如 果 选 项 数 超过 了 可 视 行 数 ， 就 开始 新 的 一 列 (参见 图 10-2 )。 
ə JList .HORIZONTAL_WRAP : 如 果 选 项 数 超过 了 可 视 行 数 ， 就 开始 新 的 一 行 ， 并 且 按 照 
水 平方 向 进行 填充 。 请 观察 图 10-2 PAR “quick”, “brown” A “hungry” WME, 
以 和 弄 清楚 垂直 换行 和 水 平 换行 的 不 同 。 
















uc silent stavie 
brown huge final 
hungry private” 
wild = abstaa 


he private static final fox jumps over the lazy dog a We ec te eM 





O Vertical @ Vertical Wrap, © Horizontal frme private st 


a e e e e e r 





pm 


图 10-2 带 有 垂直 和 水 平 换行 的 列表 框 
在 默认 情况 下 ， 用 户 可 以 选择 多 个 选项 。 为 了 选择 多 个 选项 ， 只 需 按 住 CTRL 键 ， 然 
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后 在 要 选择 的 选项 上 单 击 。 要 选择 处 于 连续 范围 内 的 选项 ， 首 先 选择 第 一 个 选项 ， 然 后 按 住 
SHIFT 键 ， 并 在 最 后 一 个 选项 上 单 击 即 可 。 
使 用 setSelectionMode 方法 ， 还 可 以 对 用 户 的 选择 模式 加 以 限制 ; 


WOrdList.Set9electionMode(ListSelectionMode1 ,SINCLE_SELECTION) ; 
// select one item at a time 
wordList.setSelectionMode(ListSelectionModel . SINGLE_INTERVAL_SELECTION) ; 
// select one item or one range of items 


也 许 你 还 记得 ,在 卷 I 中 提 到 ， 当 用 户 激活 了 基本 的 用 户 界面 构件 时 ， 它 们 将 发 出 动作 
事件 。 列 表 框 使 用 另 一 种 不 同 的 事件 通知 机 制 ， 它 不 需要 监听 动作 事件 ， 而 是 监听 列表 选择 
事件 。 可 以 向 列表 构件 添加 一 个 列表 选择 监听 器 ， 然 后 在 监听 器 中 实现 下 面 这 个 方法 ; 

public void valueChanged(ListSelectionEvent evt) 

在 用 户 选 择 了 知 干 个 选项 的 同时 ， 将 产生 一 系列 列表 选择 事件 。 假 如 用 户 在 一 个 新 选项 
上 单 击 ， 当 鼠标 按 下 的 时 候 ， 就 会 有 一 个 事件 来 报告 选项 的 改变 。 这 是 一 种 过 渡 型 事件 ， 在 
调用 

event.getValueIsAdjusting() 

时 ， 如 有 果 该 选择 仍 未 最 终结 束 则 返回 true。 然 后 ， 当 松 开 鼠标 时 ， 就 产生 另 一 事件 ， 此 时 
getValueIsAdjusting 返回 false。 如 果 你 对 这 种 过 渡 型 事件 不 感 兴趣 ， 那 么 可 以 等 待 
getValuelsAdjusting 调用 返回 false 的 事件 。 不 过 ， 如 果 和 希望 只 要 点 击 鼠 标 就 给 用 户 一 
个 即时 反馈 ， 那 么 就 需要 处 理 所 有 的 事件 。 

一 旦 被 告知 某 个 事件 已 经 发 生 ， 那 么 就 需要 弄 清楚 当前 选择 了 哪些 选项 。 如 果 是 单 选 模 式 ， 
WH getSelectedValue 可 以 获取 所 选中 列表 元 素 的 值 ， 否则 调用 getSelectedValuesList 
退回 一 个 包含 所 有 选中 选项 的 对 象 数组 。 之 后 ， 可 以 以 常规 方式 处 理 它 。 


for (String value : wordList.getSelectedValuesList()) 
// do something with value 


El 注意 : 列表 构件 不 响应 鼠标 的 双击 事件 。 正 如 Swing 设计 者 所 构想 的 那样 ， 使 用 列表 选 

择 一 个 选项 ， 然 后 点 击 某 个 按钮 执行 某 个 动作 。 但 是 ， 某 些 用 户 界 面 允 许 用 户 在 一 个 列 
表 选 项 上 双击 和 鼠标， 作为 选择 一 个 选项 并 调用 一 个 默认 动作 的 快捷 方式 。 如 果 想 实现 这 
种 行为 ， 那 么 必须 对 这 个 列表 框 添加 一 个 鼠标 监听 器 ， 然 后 按照 下 面 这 样 捕获 筷 标 事件 : 
public void mouseClicked(MouseEvent evt) 

if (evt.getClickCount() == 2) 

{ 

JList source = (JList) evt.getSource(); 


Object[] selection = source.getSelectedValuesList(); 
doAction(selection) ; 


} 
程序 清单 10-1 展示 了 一 个 填 人 了 字符 串 的 列表 框 。 请 注意 valueChanged 方法 是 怎样 
根据 被 选项 来 创建 消息 字符 的 。 
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import java.awt.*; 


import javax.swing.*; 


[** 


* This frame contains a word list and a label that shows a sentence made up from the chosen 
* words. Note that you can select multiple words with Ctrl+click and Shift+click. 


my 


class ListFrame extends JFrame 


{ 


private static final int DEFAULT_WIDTH = 400; 
private static final int DEFAULT_HEIGHT = 300; 


private JPanel listPanel; 

private JList<String> wordList; 

private JLabel label; 

private JPanel buttonPanel ; 

private ButtonGroup group; 

private String prefix = "The "; 

private String suffix = "fox jumps over the lazy dog."; 


public ListFrame() 


{ 
setSize(DEFAULT_WIDTH, DEFAULT_HEIGHT) ; 


String[] words = { "quick", "brown", "hungry", "wild", "silent", "huge", "private", 
"abstract", "static", "final" }; 


wordList = new JList<>(words); 
wordList.setVisibleRowCount (4) ; 
JScrollPane scrollPane = new JScrollPane(wordList); 


listPanel = new JPanel (); 
listPanel .add(scro]1Pane) ; 
wordList.addListSelectionListener(event -> 


StringBuilder text = new StringBuilder(prefix) ; 
for (String value : wordList.getSelectedValuesList()) 


text. append(value) ; 
text.append(" "); 


text. append (suffix) ; 


label .setText(text. toString()); 
Di 


buttonPanel = new JPanel (); 
group = new ButtonGroup() ; 
makeButton("Vertical", JList.VERTICAL) ; 
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53 makeButton("Vertical Wrap", JList.VERTICAL_WRAP) ; 

54 makeButton("Horizontal Wrap", JList.HORIZONTAL_WRAP) ; 
55 

56 add(listPanel, BorderLayout.NORTH) ; 

57 label = new JLabel (prefix + suffix); 

58 add(label, BorderLayout.CENTER) ; 

59 add(buttonPanel, BorderLayout. SOUTH) ; 

60 } 

61 

62 /** 

63 * Makes a radio button to set the layout orientation. 
64 * @param label the button label 

65 * @param orientation the orientation for the list 

66 * | 

67 private void makeButton(String label, final int orientation) 
68 { 

69 JRadioButton button = new JRadioButton(label) ; 

70 buttonPanel .add(button) ; 

71 if (group.getButtonCount() == 0) button. setSelected(true); 
n group. add (button) ; 

23 button.addActionListener(event -> 

74 

75 wordList.setLayoutOri entation (orientation) ; 


16 listPanel. revalidate(); 





e JList(EL] items) 
构建 一 个 显示 这 些 选 项 (item) 的 列表 。 
e int getVisibleRowCount() 
e void setVisibleRowCount(int c) 
获取 或 设置 列表 在 没有 滚动 条 时 显示 的 默认 行 数 。 
eint getLayoutorientation() 1.4 
e void setLayoutOrientation(int orientation) 1.4 
获取 或 设置 方向 布局 。 
参数 : orientation VERTICAL 、VERTICAL_WRAP 、HORIZONTAL_WRAP 其 中 之 一 
e int getSelectionMode( ) 
e void setSelectionMode(int mode) 
获取 或 设置 选择 方式 是 单 选 或 多 选 。 
参数 : mode SINGLE_SELECTION SINGLE_INTERVAL_SELECTION 
MULTIPLE_INTERVAL_SELECTION 其 中 之 一 


e void addListSelectionListener(ListSelectionListener listener) 
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向 列表 添加 一 个 在 每 次 选择 结果 发 生变 化 时 会 被 告知 的 监听 化。 
e List<E> getSelectedValuesList() 7 

返回 所 有 的 选 定 值 ， 如 果 选 择 结果 为 空 ， 则 返回 一 个 空 表 。 
èe E getSelectedValue( ) 

返回 第 一 个 选 定 值 ， 如 果 选 择 结果 为 空 ， 则 返回 null, 


7 i i A ; : SS T Ene ess A s3 ; 
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e void valueChanged(ListSelectionEvent e) 


在 任何 时 刻 ， 只 要 选择 结果 发 生 了 改变 ， 该 方法 就 会 被 调用 。 
10.1.2 ”列表 模式 


通过 前 一 节 ， 我 们 已 经 对 列表 构件 的 一 些 最 常用 的 方法 有 了 一 定 的 了 解 : 

1 ) 指定 一 组 在 列表 中 显示 的 固定 字符 串 。 

2 ) 将 列表 放置 到 一 个 滚动 面板 中 。 

3 ) 捕获 列表 选择 事件 。 

在 有 关 列 表 的 小 节 的 余下 部 分 ， 我 们 将 介绍 一 些 需 要 一 点 技巧 才能 处 理 的 复杂 情形 : 

e 很 长 的 列表 。 

e 内 容 会 发 生变 化 的 列表 。 

e 不 包含 字符 串 的 列表 。 

在 第 一 个 例子 中 ， 我 们 构建 的 那个 UList 构件 包含 固定 不 变 的 字符 串 集 合 。 不 过 ， 列 表 
框 中 的 选项 并 非 只 能 固定 不 变 。 那 么 我 们 应 该 怎样 添加 或 删除 列表 框 中 的 选项 呢 ? SAA A 
吃惊 的 是 ，JLi st 类 并 未 提供 实现 这 些 功能 的 任何 方法 。 相 反 地 ， 我 们 需要 进一步 了 解 列 表 
构件 的 内 部 设计 。 列 表 构件 使 用 了 模型 - 视图 - 控制 器 这 种 设计 模式 ， 将 可 视 化 外 观 〈 以 茶 
种 方式 呈现 的 一 列 选项 ) 和 底层 数据 (一 个 对 象 集合 ) 进行 了 分 离 。 

JList 类 负责 数据 的 可 视 化 外 观 。 实 际 上 ， 它 对 这 些 数据 是 怎样 存储 的 知之 甚 少 ， 它 只 
知道 可 以 通过 某 个 实现 了 ListModel 接口 的 对 象 来 获取 这 些 数据 : 

public interface ListModel<E> 

int getSize(); 
E getElementAt (int i); 


void addListDataListener(ListDataListener 1); 
void removeListDataListener(ListDataListener 1); 


通过 这 个 接口 ，JList 就 可 以 获得 元 素 的 个 数 ， 并 且 能 够 获取 每 一 个 元 素 。 为 外 ， 
JList 对 象 可 以 将 其 自身 添加 为 一 个 ListDataListener。 在 这 种 方式 下 ， 一旦 元 素 集 合 发 
生 了 变化 ， 就 会 通知 UList ， 从 而 使 它 能 够 重新 绘制 列表 。 

为 什么 这 种 通用 性 非常 有 用 呢 ? 为 什么 UList 对 象 不 直接 存储 一 个 对 象 数组 呢 ? 

请 注意 ， 这 个 接口 并 未 指定 这 些 对 象 是 怎样 存储 的 。 尤 其 是 ， 它 根本 就 没有 强制 要 求 这 


证 
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些 对 象 一 定 要 被 存储 ! 无 论 何 时 调用 getElementat 方法 ， 它 都 会 对 每 个 值 进行 重新 计算 。 
如 有 果 想 显示 一 个 极 大 的 集合 ， 而 且 又 不 想 存 储 这 些 值 ， 那 么 这 个 方法 可 能 会 有 所 帮助 。 

这 里 举 一 个 有 点 无 聊 的 示例 : 允许 用 户 在 列表 框 中 所 有 三 个 字母 的 单词 当中 进行 选择 ( 参 
见 图 10-3 )。 

三 个 字母 的 组 合 一 共有 26 x 26 x 26=17 576 个 。 我 们 不 希望 将 所 有 这 些 组 合 都 存储 起 来 ， 
而 是 想 在 用 户 滚动 这 些 单词 的 时 候 ， 依 照 请 求 对 它们 重新 计算 。 

事实 证 明 ， 这 实现 起 来 很 容易 。 其 中 比较 麻烦 的 部 分 ， 即 添加 和 删除 监听 器 ， 在 我 们 所 
继承 的 AbstractListModel 类 中 已 经 为 我 们 实现 了 。 
我 们 只 需要 提供 getSize 和 getElementAt 方法 便 可 : 

class WordListModel extends AbstractListModel<String> 

public WordListModel (int n) { length = n; } 


public int getSize() { return (int) Math.pow(26, length); } 
public String getElementAt(int n) 





// compute nth string 





图 10-3 ”从 相当 长 的 选项 列表 中 选择 


对 第 n 个 字符 串 的 计算 需要 一 点 技巧 ， 在 程序 清单 10-3 中 将 看 到 具体 实现 。 
既然 我 们 已 经 有 了 一 个 模型 ， 那 么 ， 接 下 来 我 们 就 可 以 构建 一 个 列表 ， 让 用 户 可 以 通过 
滚动 来 选择 该 模型 所 提供 的 任意 元 素 : 


JList<String> wordList = new JList<>(new WordListModel (3)): 
wordList, setSelectionMode(ListSelectionModel . SINGLE_SELECTION) ; 
JScrol]Pane scrol]Pane = new JScrol]Pane(wordList) ; 


这 里 的 关键 是 这 些 字符 串 从 来 没有 被 存储 过 ， 而 只 有 那些 用 户 实际 要 求 查看 的 字符 串 才 
会 第 生成 。 

我 们 还 必须 进行 为 一 项 设置 。 那 就 是 ， 我 们 必须 告诉 列表 构件 ， 所 有 的 选项 都 有 一 个 固 
定 的 宽度 和 高 度 。 最 简单 的 方法 就 是 通过 设置 单元 格 的 尺寸 大 小 (cell dimension) 来 设 定 原 
型 单元 格 的 值 (prototype cell value): 


wordList.setPrototypeCel1Value ("www") ; 


原型 单元 格 的 值 通常 用 来 确定 所 有 单元 格 的 尺寸 (我 们 使 用 字符 串 “www” 是 因为 “w” 
在 大 多 数字 体 中 都 是 最 宽 的 小 写字 母 )。 另 外 ， 可 以 像 下 面 这 样 设置 一 个 固定 不 变 的 单元 格 尺寸 : 


wordList.setFixedCel ]width(50); 
wordList.setFixedCel lHeight(15) ; 


如 果 你 既 没 有 设置 原型 值 也 没有 设置 固定 的 单元 格 尺寸 ， 那 么 列表 构件 就 必须 计算 每 个 
选项 的 宽度 和 高 度 。 这 可 能 需要 花费 更 长 时 间 。 
程序 清单 10-2 展示 了 示例 程序 的 框架 类 。 
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1 package longList; 

2 

3 import java.awt.*; 

4 

5 import javax.swing.*; 


6 
7 /** 

s * This frame contains a long word list and a label that shows a sentence made up from the chosen 
9 * word. 

10 */ 

11 public class LongListFrame extends JFrame 

2 { 

13 private JList<String> wordList; 

14 private JLabel label; 

15 private String prefix = "The quick brown "; 

16 private String suffix = " jumps over the lazy dog."; 


18 public LongListFrame() 


19 { 

20 wordlist = new JList<String>(new WordListModel (3)) ; 

21 wordList.setSelectionMode(ListSelectionModel . SINGLE_SELECTION) ; 
22 wordList.setPrototypeCel1Value("www’)) ; 

23 JScrollPane scrollPane = new JScrol]Pane(wordList) ; 

24 

25 JPanel p = new JPanel (); 

26 p.add(scrol | Pane) ; 

27 wordList.addListSelectionListener(event -> setSubject(wordList.getSelectedValue())) ; 
28 

29 Container contentPane = getContentPane() ; 

30 contentPane.add(p, BorderLayout.NORTH) ; 

31 label = new JLabel (prefix + suffix); 

32 contentPane.add(label, BorderLayout.CENTER) ; 

3 setSubject ("fox") ; 

34 pack(); 

35 } 

36 

37 /* 

38 * Sets the subject in the label. 

39 * @aram word the new subject that jumps over the lazy dog 
40 */ 

a public void setSubject (String word) 

42 { 

43 StringBuilder text = new StringBuilder(prefix) ; 

44 text. append (word) ; 

45 text. append (suffix) ; 

46 label .setText (text. toString()) ; 

47 } 

48 } 





从 实际 情况 来 看 ， 这 种 很 长 的 列表 没有 什么 实用 价值 。 让 用 户 滚动 浏览 一 个 巨大 的 选项 
列表 会 显得 相当 得 笨重 和 不 便 。 正 因为 如 此 ， 我 们 认为 这 种 列表 控制 设计 得 有 点 过 火 。 用 户 能 
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够 在 屏幕 上 和 舒服 操作 的 选项 列表 肯定 应 该 足够 小 ， 小 到 可 以 直接 存储 到 列表 构件 中 。 这 种 做 
法 可 以 将 编程 人 员 解 脱出 来 ， 使 他 们 不 必 把 列表 模型 作为 一 个 单独 实体 进行 处 理 。 另 一 方面 ， 
JList 类 与 Jtree、JTable 这 两 个 类 也 保持 了 一 致 ， 对 它们 来 说 ， 通 用 性 往往 会 显得 很 有 用 。 





1 package longList; 
2 
3 import javax.swing.*; 


4 

5 /** 
6 * A model that dynamically generates n-letter words. 

e *y 

8 public class WordListModel extends AbstractListModel<String> 
9 { 

10 private int length; 

11 public static final char FIRST = ‘a'; 

12 public static final char LAST = 'z'; 


14 /** 
15 * Constructs the model. 

16 * @aram n the word length 

17 */ 

18 public WordListModel (int n) 

19 { 

20 length = n; 

21 } 

22 

23 public int getSize() 

24 { 

25 return (int) Math.pow(LAST - FIRST + 1, length); 
26 

27 

28 public String getElementAt(int n) 

29 { 

30 StringBuilder r = new StringBuilder(); 
31 

32 for (int i = 0; i < length; i++) 

33 { 

34 char c = (char) (FIRST + n % (LAST - FIRST + 1)); 
35 r.insert(0, c); 

36 n= n / (LAST - FIRST + 1); 

37 } 

38 return r.toString(); 

39 } 

40 } 








e JList(ListModel<E> dataModel ) 
构建 一 个 用 指定 模型 显示 其 元 素 的 列表 。 
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e E getPrototypeCellValue( ) 

e void setPrototypeCellValue(E newValue) 
获取 或 设置 用 于 设 定 列表 中 每 一 个 单元 格 宽度 和 高 度 的 原型 单元 格 值 。 默 认 值 为 
nu11， 表 示 将 强制 对 每 一 个 单元 格 的 尺寸 进行 测量 。 

e void setFixedCellWidth(int width) 

e void setFixedCellHeight(int height) 
如 果 width 或 Height 大 于 0， 则 设 定 列表 中 每 一 个 单元 格 的 宽度 或 高 度 (单位 为 像 
素 )。 默 认 值 为 -1， 表 示 将 强制 对 每 一 个 单元 格 的 尺寸 进行 测量 。 





e int getSize() 

返回 该 模型 中 的 元 素 个 数 。 
e E getElementAt(int position) 
返回 该 模型 中 给 定位 置 上 的 一 个 元 素 。 


10.1.3 AMERRE 


不 能 直接 编辑 列表 值 的 集合 。 相 反 地 ， 必 须 先 访问 模型 ， 然 后 再 添加 或 移 除 元 素 。 不 
过 ， 说 起 来 容易 做 起 来 难 。 假 设想 要 向 列表 中 添加 更 多 的 选项 值 ， 那 么 首先 需要 通过 下 面 的 
语句 获得 对 该 模型 的 一 个 引用 : 

ListModel<String> model = list.getModel (); 


但 是 ， 正 如 在 前 一 小 节 中 看 到 的 那样 ， 这 样 做 并 不 能 带 来 任何 好 处 ， 因 为 ListModel 接口 
并 未 提供 任何 插入 或 移 除 元 素 的 方法 。 毕 竟 ， 列 表 模型 的 整个 重点 是 它 不 需要 人 存储 任何 元 素 。 
让 我 们 试 试 男 一 种 方法 吧 。JList 有 一 个 构造 器 可 以 接受 一 个 对 象 向 量 作为 参数 : 


Vector<String> values = new Vector<String>() ; 
values. addE] ement ("quick"); 
values .addElement ("brown") ; 


JList<String> list = new JList<>(values) ; 


现在 ， 就 可 以 通过 编辑 这 个 向 量 来 添加 或 移 除 元 素 了 ， 不 过 列表 并 不 知道 正在 发 生 的 事 
情 ， 因 此 也 就 无 法 对 这 种 变化 做 出 响应 。 尤 其 是 ， 当 你 向 列表 中 添加 元 素 时 ， 列 表 无 法 更 新 
它 的 显示 视图 。 因 此 ， 这 个 构造 器 也 不 太 实 用 。 

取而代之 的 是 ， 应 该 构建 一 个 DefaultListModel 对 象 ， 填 人 初始 值 ， 然 后 将 它 与 一 
个 列表 关联 起 来 。Defau1ltListMode1 类 实现 了 ListModel 接口 ， 并 管理 着 一 个 对 象 集合 。 


DefaultListModel<String> model = new DefaultListModel<>() ; 
model .addElement ("quick"); 
model .addElement ("brown") ; 


JList<String> list = new JList<>(model) ; 
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现在 ， 就 可 以 从 model 对 象 中 添加 或 移 除 元 素 值 了 。 然 后 ，mode1 对 象 会 告知 列表 发 生 
了 哪些 变化 ， 接 着 ， 列 表 会 对 自身 进行 重新 绘制 。 


model . removeElement ("quick"); 
model .addElement ("slow"); 


由 于 历史 遗留 问题 ，Defau1tListMode1 类 使 用 的 方法 名 和 集合 类 的 方法 名 并 不 相同 。 
网 认 的 列表 模型 在 内 部 是 使 用 一 个 向 量 来 存储 元 素 值 的 。 

O 警告 : JList 存在 着 多 种 构造 器 方法 ， 可 以 用 一 个 对 象 或 字符 串 数 组 或 向 量 来 构建 列表 。 
你 可 能 会 认为 这 些 构造 器 是 使 用 一 个 DefaultListModel 来 存储 这 些 元 素 值 的 。 但 情况 
并 非 如 此 ， 这 些 构造 器 构建 了 一 个 普通 而 简单 的 模型 ， 它 可 以 访问 元 素 值 ， 但 是 如 果 内 
容 发 生 了 改变 ， 它 并 不 提供 任何 通知 机 制 。 例如， 下 面 这 段 代码 是 使 用 一 个 Vector 来 
构造 UList 的 构造 器 的 代码 : 

public JList(final Vector<? extends E> listData) 


this (new AbstractListModel<E>() 


public int getSize() { return listData.size(); } 
public E getElementAt(int i) { return listData.elementAt(i); } 


}); 


} 

这 意味 着 ， 在 列表 被 创建 之 后 ， 如 果 要 修改 向 量 里 面 的 内 容 ， 那 么 这 个 列表 在 被 完 
全 重新 绘制 之 前 ， 会 将 旧 值 和 新 值 混在 一 起 ， 杂 乱 无 章 地 显示 出 来 。( 上 面 构 造 器 中 的 关 
键 字 final 并 不 能 阻止 你 在 其 他 地 方 对 这 个 向 量 进行 修改 ， 它 仅仅 表示 构造 器 本 身 不 能 
修改 1istData 引用 的 值 ; 一 定 要 有 这 个 关键 字 是 因为 1istData 对 象 是 在 内 部 类 中 使 
用 的 。) 





e ListModel<E> getMode1() 
获取 该 列表 的 模型 。 








è void addElement(E obj) 
问 该 模型 的 末端 添加 一 个 对 象 。 

eboolean removeElement(Object obj) 
从 模型 中 移 除 第 一 次 出 现 的 给 定 对 象 。 如 果 该 模型 中 包含 此 对 象 ， 则 返回 true, AM 
返回 false, 


10.1.4 值 的 绘制 
到 目前 为 止 ， 我 们 在 本 章 看 到 的 列表 包含 的 都 是 字符 串 。 实 际 上 只 需 传 递 一 个 用 Icon 
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对 象 填 充 的 数组 或 向 量 ， 便 可 以 很 容易 地 显示 一 个 图 标 列表 。 更 有 意思 的 是 ， 你 可 以 很 容易 
地 用 任何 图 形 来 表示 你 的 列表 值 。 

尽管 JList 类 可 以 自动 地 显示 字符 串 和 图 标 ， 但 是 仍然 需要 在 JList WAP RT A 
于 所 有 自 定义 图 形 的 列表 单元 格 绘制 器 。 列 表单 元 格 绘制 器 可 以 是 任何 一 个 实现 了 下 面 接口 
的 类 . 


interface ListCellRenderer<E> 


{ 
Component getListCel]RendererComponent (JList<? extends E> list, 
E value, int index, boolean isSelected, boolean cellHasFocus) ; 


} 

这 个 方法 会 为 每 个 单元 格 都 调用 一 次 ， 它 返回 一 个 用 于 绘制 单元 格 内 容 的 构件 。 无 论 何 
时 ， 只 要 某 个 单元 格 需 要 被 绘制 ， 该 构件 就 会 被 置 于 合适 的 位 置 。 

实现 单元 格 绘制 器 的 一 种 方法 是 创建 一 个 扩展 了 JComponent 的 类 ， 如 下 所 示 : 


class MyCellRenderer extends JComponent implements ListCellRenderer<Type> 


{ 
public Component getListCel]lRendererComponent(JList<? extends Type> list, 
Type value, int index, boolean isSelected, boolean cellHasFocus) 
{ 


stash away information needed for painting and size measurement 
return this; 


} 
public void paintComponent (Graphics g) 
{ 


paint code 


} 


public Dimension getPreferredSize() 


{ 


size measurement code 


instance fields 


} 

在 程序 清单 10-4 中 ， 我 们 按照 字体 的 实际 外 观 显示 这 些 可 选择 的 字体 (参见 图 10-4 )。 在 
paintComponent 方法 内 部 ， 我 们 用 每 种 字体 显示 其 自身 的 名 称 。 我 们 还 需要 确保 JList 类 
的 外 观 与 常用 颜色 相 匹 配 。 通 过 调用 JList 类 中 的 getForeground/getBackground 和 
getSelection Foreground/getSelectionBackground 
方法 可 以 获取 这 些 颜 色 。 在 getPreferredSize 方法 中 ， 
我 们 需要 使 用 在 卷 工 第 10 章 中 介绍 的 技术 来 测量 字符 串 
的 大 小 。 

如 果 要 安装 单元 格 绘制 器 ， 只 需 调 用 setCe11 Renderer 
方法 即 可 : 

fontList.setCel]Renderer(new FontCellRenderer()); 


现在 ,列表 中 的 所 有 单元 格 都 是 按照 自 定义 的 方式 绘 ” 图 10-4 具有 绘画 单元 格 的 列表 框 
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制 的 了 。 

实际 上 ， 可 以 用 一 种 更 简单 的 方法 来 编写 在 大 多 情况 下 都 能 运行 的 自 定 义 绘制 器 。 如 果 绘 
制 的 图 像 仅仅 包含 文本 、 图 标 或 者 变化 颜色 ， 那 么 通过 配置 一 个 JLabe1 就 可 以 得 到 这 样 的 一 
个 绘制 器 。 例 如 ， 为 了 用 每 种 字体 显示 该 字体 自身 的 名 称 ， 我 们 可 以 使 用 下 面 的 绘制 器 : 


class FontCellRenderer extends JLabel implements ListCel]Renderer<Font> 


public Component getListCel]RendererComponent(JList<? extends Font> list, 
Font value, int index, boolean isSelected, boolean cellHasFocus) 


{ 
Font font = (Font) value; 
setText(font.getFamily()); 
setFont (font) ; 
setOpaque(true) ; 
setBackground(isSelected ? list.getSelectionBackground() : list.getBackground()); 
setForeground(isSelected ? list.getSelectionForeground() : list.getForeground()); 
return this; 


} 
} 


注意 ， 这 里 没有 编写 任何 paintComponent 或 getPreferredSize 方 法 ; JLabel 类 
早已 实现 了 这 些 方法 ， 完 全 能 够 满足 我 们 的 要 求 。 我 们 要 做 的 全 部 工作 就 是 通过 设置 文本 、 
字体 以 及 颜色 来 恰当 地 配置 标签 。 

这 段 代 码 在 某 些 情形 下 确实 是 一 个 很 便利 的 捷径 ， 因 为 在 这 些 情形 中 ， 有 现成 的 构 
件 一 一 JLabe1， 它 已 经 提供 了 绘制 单元 格 值 所 需 的 全 部 功能 。 

我 们 在 样 例 程序 中 使 用 了 JLabel， 但 是 我 们 给 出 的 是 更 泛 化 的 代码 ， 这 样 你 就 可 以 在 需 
要 在 列表 单元 格 中 显示 任意 图 形 时 ， 通 过 修改 这 段 代 码 来 实现 。 

& 警告 : 在 每 一 个 getListCce11RendererComponent 调用 中 都 构建 一 个 新 的 构件 并 不 是 

一 个 好 主意 。 因 为 如 果 用 户 滚动 了 许多 个 列表 项 ， 那 么 每 一 次 都 需要 构建 一 个 新 构件 。 

而 对 已 有 构件 进行 重 配置 则 显得 更 安全 更 高 效 。 





1 package listRendering; 
2 

3 import java.awt.*; 

4 import javax.swing.*; 


5 

6 /** 

7 * A cell renderer for Font objects that renders the font name in its own font. 

e */ 

9 public class FontCellRenderer extends JComponent implements ListCellRenderer<Font> 
10 { 

11 private Font font; 

12 private Color background; 

13 private Color foreground; 


15 public Component getListCel]RendererComponent(JList<? extends Font> list, 
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16 Font value, int index, boolean isSelected, boolean cel ]HasFocus) 
17 { 

18 font = value; 

19 background = isSelected ? list.getSelectionBackground() : list.getBackground() ; 
20 foreground = isSelected ? list.getSelectionForeground() : list.getForeground() ; 
21 return this; 

22 } 

23 

24 public void paintComponent (Graphics g) 

25 { 

26 String text = font.getFamily(); 

27 FontMetrics fm = g.getFontMetrics(font) ; 

28 g.setColor (background) ; 

29 g.fillRect(0, 0, getWidth(), getHeight()); 

30 g.setColor(foreground) ; 

31 g.setFont (font) ; 

2 g.drawString(text, 0, fm.getAscent()) ; 

33 } 

34 

35 public Dimension getPreferredSize() 

36 { 

37 String text = font.getFamily(); 

38 Graphics g = getGraphics(); 

39 FontMetrics fm = g.getFontMetrics(font) ; 

40 return new Dimension(fm.stringWidth(text), fm.getHeight()) ; 

41 } 

n } 








e Color getBackground( ) 
返回 未 选 定单 元 格 的 背景 颜色 。 


e Color getSelectionBackground ( ) 


返回 选 定单 元 格 的 背景 颜色 。 


e Color getForeground( ) 


返回 未 选 定 单元 格 的 前 景 颜 色 。 


eColor getSelectionForeground( ) 


返回 选 定单 元 格 的 前 景 颜色 。 


e void setCellRenderer(ListCellRenderer<? super E> cellRenderer) 


BOE Feild FURS PETH Ze il Air o 





e Component getListCel1RendererComponent(JList<? extends E> list, È 
item, int index, boolean isSelected, boolean hasFocus) 
返回 一 个 其 paint 方法 用 于 绘制 单元 格 内 容 的 构件 ， 如 果 列 表 的 单元 格 尺 寸 没 有 固 
定 ， 那 么 该 构件 还 必须 实现 getPreferredSize, 
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参数 : list 单元 格 正 在 被 绘制 的 列表 
item 要 绘制 的 选项 
index 存储 在 模型 中 的 选项 索引 
isSelected true 表示 指定 的 单元 格 被 选 定 
hasFocus true 表示 焦点 在 指定 的 单元 格 上 
10.2 ”表格 


JTable 构件 用 于 显示 二 维 对 象 表格 。 当 然 ， 表 格 在 用 户 界面 中 很 常见 。 Swing 开发 小 
组 将 大 量 的 精力 投入 到 了 表格 控制 方面 。 表 格 本 身 比较 复杂 ， 但 是 它 可 能 比 其 他 Swing 类 更 
为 成 功 ， 因 为 JTable 构件 隐藏 了 更 多 的 复杂 性 。 只 需 编 写 几 行 代码 就 能 够 产生 具有 完全 功 
能 化 的 、 行 为 丰富 的 表格 。 当 然 ， 还 可 以 编写 更 多 的 代码 ， 为 具体 应 用 定制 显示 外 观 和 运行 
特性 。 

在 本 市 中 ,我 们 将 着 重 讲解 怎样 产生 简单 表格 ， 用 户 怎 样 与 它们 交互 ， 以 及 怎样 进行 一 
些 最 常见 的 调整 操作 。 与 其 他 一 些 复杂 的 Swing 构件 一 样 ， 我 们 不 可 能 覆盖 所 有 的 细节 。 如 
来 想 获 得 详细 信息 ， 请 查阅 David M. Geary 撰写 的 《 Graphic Java ) (第 3 版 ) (Prentice Hall, 
1999 ) BK Kim Topley 撰写 的 《 Core Swing )(Prentice Hall, 1999), 


10.2.1 简单 表格 


与 UList 构件 类 似 ，JTab1le 并 不 存储 它 自己 的 数据 ， 而 是 从 一 个 表格 模型 中 获取 它 的 
数据 。JTable 类 有 一 个 构造 器 能 够 将 一 个 二 维 对 象 数组 包装 进 一 个 默认 的 模型 。 这 也 正 是 
我 们 第 一 个 示例 程序 要 用 到 的 策略 。 在 本 章 的 后 续 部 分 ， 我 们 将 转向 介绍 表格 模型 。 

图 10-5 展示 了 一 个 典型 的 表格 ， 用 于 描述 太阳 系 各 个 行星 的 属性 。( 如 果 一 个 行星 主要 
由 氧气 和 氮气 组 成 ， 那 么 它 就 是 气态 行星 。 对 于 “ Color” 项， 你 不 必 太 当真 ， 我 们 之 所 以 
将 它 添加 为 一 列 是 因为 在 后 面 的 示例 代码 中 ， 它 会 
很 有 用 。) 

正如 你 在 程序 清单 10-5 中 看 到 的 那样 ， 表 格 中 
的 数据 是 以 Object 值 的 二 维 数组 的 形式 存储 的 : 

A cells = 





{ "Mercury", 2440.0, 0, false, Color. YELLOW }, a Te 
{ "Venus", 6052.0, 0, false, Color. YELLOW }, 图 10-5 简单 表格 


} 


注意 : 这 里 ， 我 们 充分 利用 了 自动 装 箱 机 制 。 第 二 列 、 第 三 列 、 第 四 列 中 的 项 会 自动 转 
th & FA A Double, Integer 和 Boolean 的 对 象 。 


该 表格 直接 调用 每 个 对 象 上 的 toString 方法 来 显示 它们 ， 这 也 正 是 为 什么 颜色 显示 成 
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为 java.awt.Color[r=...,g=...,b=...] 的 原因 所 在 。 
可 以 用 一 个 单独 的 字符 串 数 组 来 提供 列 名 : 
String[] columnNames = { "Planet", "Radius", "Moons", "Gaseous", "Color" }; 
接着 ， 就 可 以 从 单元 格 和 列 名 数组 中 构建 一 个 表格 : 
JTable table = new JTable(cells, columnNames) ; 
最 后 ， 通 过 将 表格 包装 到 一 个 JScro11Pane 中 这 种 常用 方法 来 添加 滚动 条 : 
JScrollPane pane = new JScrollPane (table), 
注意 : JTable 与 JList 不 同 ， 它 并 非 泛 型 。 这 么 做 是 有 原因 的 ， 列表 中 的 元 素 总 是 具 
有 统一 类 型 的 ， 但 是 ， 通 常 整个 表格 不 会 只 有 单一 的 元 素 类 型 。 例 如 ， 在 我 们 的 示例 中 ， 
行星 名 是 字符 串 ， 颜 色 是 java.awt .Color 对 象 。 


在 滚动 表格 时 ， 列 表 头 并 不 会 滑 出 视图 的 外 面 。 

接着 ， 单 击 列表 头 的 某 一 列 ， 并 且 向 左 或 向 右 拖拉 。 看 看 整个 列 是 怎样 移 开 的 (参见 
图 10-6 )， 你 可 以 将 它 放 到 别 的 位 置 上 。 这 种 列 的 重新 排列 只 是 视图 上 的 重新 排列 ， 对 数据 
模型 没有 任何 影 啊 。 

如 果 要 调整 列 的 尺寸 大 小 ， 只 需 将 鼠标 移 到 两 列 之 间 ， 直 到 鼠标 的 形状 变 成 箭头 为 止 ， 
然后 将 列 的 边界 拖 移 到 你 期 望 的 位 置 上 (参见 图 10-7 )。 
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用 户 可 以 通过 点 击 行 中 任何 一 个 地 方 来 选中 一 行 ， 而 选中 的 行 会 高 亮 显 示 ， 后 面 将 会 介 
绍 怎样 获取 这 些 选 择 事 件 。 通 过 单 击 一 个 单元 格 并 键 和 人 数据 ， 用 户 还 可 以 编辑 表格 中 的 各 个 
项 。 不 过 ， 在 这 个 代码 示例 中 ， 这 些 编辑 并 没有 改变 底层 的 数据 。 在 程序 中 ， 你 应 该 要 么 使 
这 些 单元 格 不 可 编辑 ， 要 么 处 理 单元 格 编辑 事件 并 更 新 你 的 模型 。 我 们 将 会 在 本 市 的 后 面 对 
这 些 问 题 进行 讨论 。 


最 后 ， 点 击 列 的 头 ， 行 就 会 自动 排序 。 如 果 再 次 点 击 ， 排 序 顺 序 就 会 反 过 来 。 这 个 行为 
是 通过 下 面 的 调用 激活 的 : 


table, setAutoCreateRowSorter(true) ; 
可 以 使 用 下 面 的 调用 对 表格 进行 打印 : 


table.print(); 
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此 时 会 出 现 一 个 打印 对 话 框 ， 并 将 表格 传送 给 打印 机 。 我 们 将 在 第 11 章 讨 论 定 制 打 印 


注意 : 如 果 调 整 TableTest 框架 的 尺寸 ， 使 它 的 高 度 超过 了 表 的 高 度 ， 那 么 就 会 看 到 表 
的 下 方 有 一 块 灰色 区 域 。 与 UList f JTree 构件 不 同 ， 表 没有 填充 滚动 面板 视图 。 当 
希望 支持 拖 搜 时 ， 这 可 能 会 成 为 一 个 问题 (关于 拖 搜 的 更 多 信息 ， 请 查看 第 11 章 )。 在 
这 种 情况 下 ， 可 以 调用 


table,.setF111SViewportHeight(true) ; 


O BE: 如 果 没 有 将 表格 包装 在 滚动 面板 中 ， 那 么 就 需要 显 式 地 添加 表 头 : 
add(table.getTableHeader(), BorderLayout. NORTH) ; 





package table; 


import java.awt.*; 
import java.awt.print.*; 


import javax.swing.*; 


/** 
* This program demonstrates how to show a simple table. 
10 =* @version 1.13 2016-05-10 
11 * @author Cay Horstmann 
1 */ 
13 public class TableTest 


woe N OOO a ē & wW N pH 


15 public static void main(String[] args) 


16 { 

17 EventQueue.invokeLater(() -> 

18 { 

19 JFrame frame = new PlanetTableFrame() ; 
20 frame. setTitle("TableTest") ; 

21 frame.setDefaultCloseOperation(JFrame. EXIT_ON_CLOSE) ; 
22 frame. setVisible(true) ; 

23 Hi 

24 } 

25 } 

26 

27 /** 

28 * This frame contains a table of planet data. 

29 / 

30 Class PlanetTableFrame extends JFrame 

31 { 


32 private String{] columnNames = { "Planet", "Radius", "Moons", "Gaseous", "Color" }: 

33 private Object(][] cells = { { "Mercury", 2440.0, 0, false, Color. YELLOW }, 

34 { "Venus", 6052.0, 0, false, Color. YELLOW }, { "Earth", 6378.0, 1, false, Color.BLUE }, 
35 { "Mars", 3397.0, 2, false, Color.RED }, { "Jupiter", 71492.0, 16, true, Color.ORANGE }, 
36 { "Saturn", 60268.0, 18, true, Color.ORANGE }, 





#10% BB Swing 489 


37 { "Uranus", 25559.0, 17, true, Color.BLUE }, { "Neptune", 24766.0, 8, true, Color.BLUE }, 
38 { "Pluto", 1137.0, 1, false, Color.BLACK } }; 

39 

40 public PlanetTableFrame() 

4 { 

42 final JTable table = new JTable(cells, columnNames) ; 

43 table. setAutoCreateRowSorter(true) ; 

44 add(new JScrol1Pane(table), BorderLayout. CENTER) ; 

45 ]Button printButton = new JButton("Print”) ; 

46 printButton.addActionListener(event -> 

47 { 

48 try { table.print(); } 

49 catch (SecurityException | PrinterException ex) { ex.printStackTrace() ; } 
50 pHi 

51 JPanel buttonPanel = new JPanel (); 

52 buttonPanel .add(printButton) ; 

53 add(buttonPanel, BorderLayout. SOUTH) ; 

54 pack(); 

55 } 

s 1 





ə JTable(Object[][] entries, Object[] columnNames ) 
用 默认 的 表格 模型 构建 一 个 表格 。 

evoid print() 5.0 
显示 打印 对 话 框 ， 并 打印 该 表格 。 

e boolean getAutoCreateRowSorter() 6 

e void setAutoCreateRowSorter(boolean newValue) 6 
获取 或 设置 autoCreateRowSorter 属性 ， 默 认 值 为 fal1se。 如 果 进 行 了 设置 ， 只 要 
模型 发 生变 化 ， 就 会 自动 设置 一 个 默认 的 行 排序 磊 。 

e boolean getFillsViewportHeight() 6 

e void setFillsViewportHeight(boolean newValue) 6 
获取 或 设置 fi11sViewportHeight 属性 ， 默 认 值 为 false。 如 果 进 行 了 设置 ， 该 表 
格 就 总 是 会 填充 其 外 围 的 视图 。 


10.2.2 ”表格 模型 


在 上 一 个 示例 中 ， 表 格 数据 是 存储 在 一 个 二 维 数组 中 的 。 不 过 ， 通 常 不 应 该 在 自己 的 代 
码 中 使 用 这 种 策略 。 如 果 你 发 现 自己 在 将 数据 装 和 一 个 数组 中 ， 然 后 作为 一 个 表格 显示 出 
来 ,那么 就 应 该 考虑 实现 自己 的 表格 模型 了 。 

表格 模型 实现 起 来 特别 简单 ， 因 为 你 可 以 充分 利用 AbstractTableModel 类 ， 它 实现 
了 大 部 分 必需 的 方法 。 你 仅仅 需要 提供 下 面 三 个 方法 便 可 : 


public int getRowCount () ; 
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public int getColumnCount(); 
public Object getValueAt(int row, int column); 


实现 getValueAt 方法 有 多 种 途径 。 例 如 ， 如 果 你 想 显 示 包 含 数 据 库 查 询 结果 的 RowSet 
的 内 容 ， 只 需 提 供 下 面 的 方法 : 


public Object getValueAt(int r, int c) 
{ 
try 


rowSet.absolute(r + 1); 
return rowSet.getObject(c + 1); 


} 
catch (SQLException e) 


e.printStackTrace(); 
return null; 
} 
} 


我 们 的 示例 程序 相当 简单 ， 我 们 构建 了 PT 


a 


一 个 只 是 用 来 显示 某 些 计算 结果 的 表格 ， 这 i 
些 计 算 结果 也 就 是 在 不 同 利率 条 件 下 的 投资 [i5083 


pe er | e f pat 
S 
© 
© 
ois 
© 
i 


127628.16 
从 134009.56 67710.01 
增长 额 ( 见 图 10-8 ) o 140710.04 182803.91 

147745.54 

ye? ` 155132.82 168947.90 
getValueAt 方 法 计算 出 正确 值 ， J 将 162889.46 

171033.94 |189829.86 258042.64 
其 格 式 化 79585.63 51817.01 |281266.48 
I 8 88564.91 |213292.83 |240984.50 71962.37 |306580.45 


33417270 | ; 
364248 25 17724.82 | 


97993.16 |226090.40 
07892.82 |239655.82 |275903.15 _ 


public Object getValueAt(int r, int c) = zi d 
图 10-8 一 个 投资 增长 额 表 格 





double rate = (c + mnRate) / 100.0; 
int nperiods = r; 

double futureBalance = INITIAL_BALANCE * Math.pow(1 + rate, nperiods); 
return String. format("%.2f", futureBalance) ; 


} 
getrowCount 和 getColumnCount 方法 只 是 返回 行 数 和 列 数 。 


public int getRowCount() { return years; } 
public int getColumnCount() { return maxRate - minRate + 1; } 


如 果 不 提 供 列 名 ， 那么 AbstractTableModel 的 getColumnName 方法 会 将 列 命名 为 
A、B、C 等 。 如 果 要 改变 列 名 ， 请 覆盖 getCo1umnName 方法 。 通 常 需要 覆盖 默认 的 行为 。 
在 这 个 示例 中 ， 我 们 只 是 将 每 列 用 利率 标识 了 出 来 。 

public String getColumnName(int c) { return (c + minRate) + "%": } 


程序 清单 10-6 中 显示 了 完整 的 源 代码 。 





1 package tableModel; 
2 
3 Import java.awt.*: 
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import javax.swing.*; 
import javax.swing.table.*; 


js 
* This program shows how to build a table from a table model. 
* @ersion 1.03 2006-05-10 


* @author Cay Horstmann 
* 


public class InvestmentTable 


{ 
public static void main(String[] args) 
EventQueue.invokeLater(() -> 
{ 
JFrame frame = new InvestmentTableFrame() ; 
frame.setTitle("InvestmentTable') ; 
frame.setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE) ; 
frame. setVisible(true) ; 
Wi 
} 
} 
/** 


* This frame contains the investment table. 
$ 


class InvestmentTableFrame extends JFrame 


{ 


public InvestmentTableFrame() 


{ 
TableModel model = new InvestmentTableModel (30, 5, 10); 


JTable table = new JTable(model) ; 
add(new JScrol]Pane(table)) ; 
pack() ; 


} 
[** 
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* This table model computes the cell entries each time they are requested. The table contents 
* shows the growth of an investment for a number of years under different interest rates. 


* 
class InvestmentTableModel extends AbstractTabl eModel 


{ 
private static double INITIAL_BALANCE = 100000.0; 


private int years; 
private int minRate; 
private int maxRate; 


[** 
* Constructs an investment table model. 


* @param y the number of years 
* @param r1 the lowest interest rate to tabulate 
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58 * @aram r2 the highest interest rate to tabulate 
59 */ 
60 public InvestmentTableModel (int y, int r1, int r2) 


62 years = y; 
63 minRate = r1; 
64 maxRate = r2; 
65 } 


67 public int getRowCount () 


69 return years; 


70 } 
n public int getColumnCount() 
{ 


74 return maxRate - minRate + 1; 


77 public Object getValueAt(int r, int c) 


79 double rate = (c + minRate) / 100.0; 

80 int nperiods = r; 

81 double futureBalance = INITIAL_BALANCE * Math.pow(1 + rate, nperiods): 
82 return String. format("%.2f", futureBalance) ; 

83 } 


85 public String getColumnName(int c) 


87 return (c + minRate) + "%": 





e int getRowCount( ) 
èe int getColumnCount( ) 
获取 表 模 型 中 的 行 和 列 的 数量 。 
e Object getValueAt(int row, int column) 
获取 在 给 定 的 行 和 列 所 确定 的 位 置 处 的 值 。 
e void setValueAt(Object newValue, int row, int column) 
议 置 在 给 定 的 行 和 列 所 确定 的 位 置 处 的 值 。 
èe boolean isCellEditable(int row, int column) 
如 有 果 在 给 定 的 行 和 列 所 确定 的 位 置 处 的 值 是 可 编辑 的 ， 则 返回 true, 


e String getColumnName(int column) 


获取 列 的 名 字 。 
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10.2.3 ”对 行 和 列 的 操作 


在 本 小 节 中 ， 你 会 看 到 怎样 操作 一 个 表格 中 的 行 和 列 。 在 你 阅读 本 材料 的 整个 过 程 中 ， 
要 牢记 Swing 中 的 表格 是 相当 不 对 称 的 ， 也 就 是 你 可 以 实施 的 行 操作 和 列 操作 会 有 所 不 同 。 
表格 构件 已 经 被 优化 过 ， 以 便 能 够 显示 具有 相同 结构 的 行 信息 ， 例 如 ， 一 次 数据 库 查询 的 结 
果 ， 而 不 是 任意 的 二 维 对 象 表 格 。 你 将 会 看 到 ， 这 种 不 对 称 性 贯穿 于 本 小 市。 

1. 各 种 列 类 

在 下 一 个 示例 中 ， 我 们 将 再 次 展示 行星 数据 ， 不 过 这 次 我 们 会 给 出 更 多 的 有 关 表 格 列 类 
型 的 信息 。 这 是 通过 在 表格 模型 中 定义 下 面 这 个 方 


法 来 实现 的 ， 表 10-1 默认 的 绘制 操作 


Class<?> getColumnClass(int columnIndex) = chelate 
Boolean 复 选 杠 

这 个 方法 可 以 返回 一 个 描述 列 类 型 的 类 。 je 图 像 

JTable 类 会 为 该 类 选取 合适 的 绘制 器， 表 10-1 Object FRR 


显示 了 默认 的 绘制 动作 。 
可 以 在 图 10-9 中 看 到 复 选 框 和 图 像 。 (感谢 Jim Evins 提供 了 这 些 行星 图 像 ， 网 址 为 : 
http://www.snaught.com/ JimsCoollcons/Planets 。) 


p lapie owe 
Jj T Gaseous] 
E ljava. awt. Color[r=255,g=255,b=0] 
2) E 


ar 3, H 1- 一 255,9=0,b=0] 


71,492 二 awt. Colorfr=255,g=200,b=0] 
60, wae] of banen ni =255,9=200,b= S 9 O 


图 10-9 具有 单元 格 绘制 器 的 表格 






Rea G aC aw a Se 



















要 绘制 其 他 类 型 ,需要 安装 定制 的 绘制 器 ， 请 参见 第 10.2.41. 

2. 访问 表格 列 

JTable 类 将 有 关 表 格 列 的 信息 存放 在 类 型 为 TableColumn 的 对 象 中 ， 由 一 个 Table- 
ColumnModel 对 象 负责 管理 这 些 列 。( 图 10-10 展示 了 最 重要 的 表格 类 之 间 的 关系 。) 如 果 不 
想 动 态 地 插 人 或 删除 ， 那 么 最 好 不 要 过 多 地 使 用 表格 列 模型 。 列 模型 最 常见 的 用 法 是 直接 获 
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取 一 个 TableColumn 对 象 ， 


int columnIndex=.. .; 
TableColumn column = table.getColumnModel () .getColumn(columnIndex) ; 


3. 改变 列 的 大 小 

TableColumn 类 可 以 控制 更 改 列 的 大 四 
小 的 行为 。 使 用 下 面 这 些 方法 ， 可 以 设置 首 prep 
选 的 、 最 小 的 以 及 最 大 的 宽度 : | oe EFH 


void setPreferredWidth(int width) 
void setMinWidth(int width) 
void setMaxWidth(int width) 


这 些 信息 将 提供 给 表格 构件 ， 以 便 对 列 


进行 布局 。 E 
使 用 方法 E nen 


void setResizable(boolean resizable) | = + Eee ERP -| 
可 以 控制 是 否 允许 用 户 改变 列 的 大 小 。 5. 二 
可 以 使 用 下 面 这 个 方法 在 程序 中 改变 列 


















的 大 小 : 

void setWidth(int width) 

当 调 整 了 一 个 列 的 大 小 时 ， 默 认 情 况 下 表格 的 总 体 大 小 会 保持 不 变 。 当 然 ， 更 改过 大 小 
的 列 的 宽度 的 增加 值 或 减 小 值 会 分 摊 到 其 他 列 上 。 默 认 方 式 是 更 改 那些 在 被 改变 了 大 小 的 列 
右边 的 所 有 列 的 大 小 。 这 是 一 种 很 好 的 默认 方式 ， 因 为 这 样 使 得 用 户 可 以 通过 将 所 有 列 从 左 
到 右 移动 ， 将 它们 调整 为 自己 所 期 望 的 宽度 。 

使 用 下 面 这 个 方法 ， 可 以 设置 表 10-2 中 列 出 的 其 他 行为 : 


void setAutoResizeMode(int mode) 


图 10-10 ”表格 类 之 间 的 关系 图 


表 10-2 ”变更 列 大 小 的 模式 


模 xt T FA 

AUTO_RESIZE_OFF 不 更 改 其 他 列 的 大 小 ， 而 是 更 改 整个 表格 的 宽度 

AUTO_RESIZE_NEXT_COLUMN 只 更 改 下 一 列 的 大 小 

AUTO_RESIZE_SUBSEQUENT_COLUMNS 均匀 地 更 改 后 续 列 的 大 小 ， 这 是 默认 的 行为 

AUTO_RESIZE_LAST_COLUMN 只 更 改 最 后 一 列 的 大 小 

AUTO_RESIZE_ALL_COLUMNS 更 改 表格 中 的 所 有 列 的 大 小 ， 这 并 不 是 一 种 很 明智 的 选择 ， 
因为 这 阻碍 了 用 户 只 对 数列 而 不 是 整个 表 进 行 调整 以 达到 自己 
期 望 大 小 的 行为 


4. 改变 行 的 大 小 
行 的 高 度 是 直接 由 JTable 类 管理 的 。 如 果 单 元 格 比 默认 值 高 ， 那 么 可 以 像 下 面 这 样 设 
置 行 的 高 度 : 
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table. setRowHei ght (hei ght) ; 

默认 情况 下 ， 表 格 中 的 所 有 行 都 具有 相同 的 高 度 ， 可 以 用 下 面 的 调用 来 为 每 一 行 单独 设 
置 高 度 : 

table, setRowHeight (row, height); 

实际 的 行 高 度 等 于 用 这 些 方法 设置 的 行 高 度 减 去 行 边 距 ， 其 中 行 边 距 的 默认 值 是 1 个 像 
素 ， 但 是 可 以 通过 下 面 的 调用 来 修改 它 : 

table,SetRowMargin(margin) ; 

5. 选择 行 、 列 和 单元 格 

利用 不 同 的 选择 模式 ， 用 户 可 以 分 别 选 择 表 格 中 的 行 、 列 或 者 单独 的 单元 格 。 黑 认 人 情况 
下 ， 使 能 的 是 行 选 择 ， 点 击 一 个 单元 格 的 内 部 就 可 以 选择 整 行 (参见 图 10-9 )。 调 用 

table,. setRowSelectionAllowed(false) 
可 以 禁用 行 选择 。 

当 行 选择 功能 可 用 时 ， 可 以 控制 用 户 是 否 可 以 选择 单一 行 、 连 续 几 行 或 者 任意 几 行 。 此 
时 ， 需 要 获取 选择 模式 ， 然 后 调用 它 的 setSelectionMode 方法 : 

table.getSelecti onModel () ,Set9electionMode (mode) ; 


在 这 里 ，mode 是 下 面 三 个 值 的 其 中 一 个 : 


ListSelectionModel .SINGLE SELECTION 
ListSelectionModel .SINGLE_INTERVAL_SELECTION 
ListSelectionModel .MULTIPLE_INTERVAL_SELECTION 


默认 情况 下 ， 列 选择 是 禁用 的 。 不 过 可 以 调用 下 面 这 个 方法 局 用 列 选择 : 

table,. setColumnSelectionAllowed(true) 

同时 启用 行 选择 和 列 选择 等 价 于 启用 单元 格 选 择 ， 这 样 用户 就 可 以 选择 一 定 范 围 内 的 单 
元 格 (参见 图 10-11 )。 也 可 以 使 用 下 面 的 调用 完成 这 项 设置 : 

table. setCel]Se] ectionEnabled(true) 

可 以 运行 程序 清单 10-7 中 的 程序 ， 观 察 一 下 单元 格 选择 的 运行 情况 。 启 用 Selection ¥X 
单 中 的 行 、 列 或 单元 格 选项 ， 然 后 观察 选择 行为 是 如 何 改变 的 。 

可 以 通过 调用 getSelectedRows 方法 和 getSelectedColumns 方法 来 查看 选中 了 了 哪 
些 行 及 哪些 列 。 这 两 个 方法 都 返回 一 个 由 被 选 定 项 的 索引 构成 的 int[] 数组 。 注 意 ， 这 些 索 
引 值 是 表格 视图 中 的 索引 值 ， 而 不 是 底层 表格 模型 中 的 索引 值 。 尝 试 着 选择 一 些 行 和 列 ， 然 
后 将 列 拖 搜 到 不 同 的 位 置 ， 并 通过 点 击 列 头 来 对 这 些 行 进行 排序 。 使 用 Print Selection 菜单 
项 来 查看 它 会 报告 哪些 行 和 列 被 选中 。 

如 果 要 将 表格 索引 值 转译 为 表格 模型 索引 值 ， 可 以 使 用 JTable 的 ConvertRowIndexToModel 
和 convertColumnIndexToModel 方法 。 

6. 对 行 排序 

正如 在 第 一 个 表格 示例 中 看 到 的 那样 ， 向 JTable 中 添加 行 排序 机 制 是 很 容易 的 ， 只 需 
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调用 setAutoCreateRowSorter 方法 。 但 是 ， 要 对 排序 行为 进行 细 粒 度 的 控制 ， 就 必须 向 
JTable 中 安装 一 个 TableRowSorter<M> 对 象 ， 并 对 其 进行 定制 化 。 类 型 参数 M 表示 表格 
模型 ， 它 必须 是 TableModel 接口 的 子 类 型 。 


TableRowSorter<TableModel> sorter = new TableRowSorter<TableMode]>(model]); 
table. setRowSorter (sorter); 


fi TableRowColumntest 
Selection Edit 


f 


Radius | Moons |Gaseous| are g ; g 
3,397 2 java.awt.Colorfr=255,g=0,b=0] 


java. awt. Color[r=255,g=200,b=0] 
java awt. Color{r=255,9=200,b=0] 


由 java.awtCoiorfr=0,g=0,b=255] 





图 10-11 选择 一 个 单元 格 范围 


某 些 列 是 不 可 排序 的 ， 例 如 ， 在 我 们 的 行星 数据 中 的 图 像 列 ， 可 以 通过 下 面 的 调用 来 关 
财 排 序 机 制 : 
sorter.setSortable(IMAGE_COLUMN, false); 


可 以 对 每 个 列 都 安装 一 个 定制 的 比较 器 。 在 我 们 的 示例 中 ,我们 将 对 Color 列 中 的 颜色 
进行 排序 ， 因 为 我 们 相对 于 红色 来 说 ， 更 喜欢 蓝 色 和 绿色 。 当 你 点 击 Color 列 时 ， 将 会 看 到 
蓝 色 行 星 出 现在 表格 底部 ， 这 是 通过 下 面 的 调用 完成 的 : 


sorter.setComparator(COLOR_COLUMN, new Comparator<Color>() 
public int compare(Color cl, Color c2) 


int d = cl.getBlue() - c2.getBlue(); 
if (d != 0) return d; 
d = cl.getGreen() - c2.getGreen(); 
if (d != 0) return d; 
return cl.getRed() - c2.getRed(); 
} 
}); 


如 有 果 不 指 定 列 的 比较 器 ， 那 么 排序 顺序 就 是 按照 下 面 的 原则 确定 的 : 
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1) 如 果 列 所 属 的 类 是 String， 就 使 用 Co11ator .getInstance() 方法 返回 的 默认 比 
较 器 。 它 按照 适用 于 当前 locale 的 方式 对 字符 串 排 序 。( 参 见 第 7 章 以 了 解 locale 和 比较 逢 的 
更 多 信息 )。 

2) 如 果 列 所 属 的 类 型 实现 了 Comparab1le， 则 使 用 它 的 compareTo 方法 。 

3) 如 果 已 经 为 排序 器 设置 过 TableStringConverter ， 就 用 默认 比较 需 对 转换 做 的 
toString 方法 返回 的 字符 串 进行 排序 。 如 果 要 使 用 该 方法 ， 可 以 像 下 面 这 样 定义 转换 人 船 : 


sorter.setStringConverter(new TableStringConverter() 
public String toString(TableModel model, int row, int column) 


Object value = model.getValueAt(row, column); 
convert value to a string and return it 
Ds 
4) 否则 ， 在 单元 格 的 值 上 调用 toString 方法 ， 然 后 用 默认 比较 器 对 它们 进行 比较 。 
7. 过 滤 行 
除了 可 以 对 行 排 序 之 外 ，TableRowSorter 还 可 以 有 选择 性 地 隐藏 行 ， 这 种 处 理 称 为 过 
X (filtering)。 要 想 激 活 过 滤 机 制 ， 需 要 设置 RowFilter。 例 如 ， 要 包含 所 有 至 少 有 一 个 卫 
星 的 行星 行 ， 可 以 调用 : 
sorter. setRowFi]ter(RowFilter.numberFilter(ComparisonType.NOT_EQUAL, 0, MOONS_COLUMN)) ; 
这 里 我 们 使 用 了 预定 义 的 过 滤器 ， 即 数字 过 滤器 。 要 构建 数字 过 滤器 ， 需 要 提供 : 
o 比较 类 型 (EQUAL 、NOT_EQUAL AFTER 和 BEFORE 之 一 )。 
e Number 的 某 个 子 类 的 一 个 对 象 (例如 Integer fl Double), RA 524% Hy Number 
对 象 属于 相同 的 类 的 对 象 才 在 考虑 的 范围 内 。 
e 0 或 多 列 的 索引 值 ， 如 果 不 提供 任何 索引 值 ， 那 么 所 有 的 列 都 被 搜索 。 
静态 的 RowFilter .dataFilter 方 法 以 相同 的 方式 构建 了 日 期 过 滤器 ， 这 里 需要 提供 
Date 对 象 而 不 是 Number 对 象 。 
最 后 ， 静 态 的 RowFilter.regexFilter 方法 构建 的 过 滤器 可 以 查找 匹配 某 个 正则 表达 
式 的 字符 串 。 例 如 : 
sorter. setRowFilter (RowFilter. regexFilter(".*[As]$", PLANET_COLUMN)); 
将 只 显示 那些 名 字 以 “s ”结尾 的 行星 (参见 第 2 章 以 了 解 有 关 正 则 表达 式 的 更 新 信息 )。 
还 可 以 用 andFilter、orFilter 和 notFilter 方法 来 组 合 过 滤器 ， 例 如 ， 要 过 滤 掉 
名 字 不 是 以 “s” 结 尾 ， 并 且 至 少 有 一 颗 卫 星 的 行星 ， 可 以 使 用 下 面 的 过 滤器 组 合 : 
sorter. setRowFilter(RowFilter.andFilter(Arrays.asList( 
RowFilter, regexFilter(".*[As]$", PLANET_COLUMN) , 
RowFilter.numberFilter(ComparisonType.NOT_EQUAL, 0, MOONS COLUMN) )) ; 
O 警告 : 令 人 恼火 的 是 ，andFilter 和 orFilter 方法 未 使 用 可 变 参 数 ， 而 是 单个 的 类 型 
为 Iterable 的 参数 。 
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要 实现 目 己 的 过 滤器 ， 需 要 提供 RowFilter 的 一 个 子 类 ， 并 实现 include 方法 来 表示 
哪些 行 应 该 显示 。 这 很 容易 实现 ， 但 是 RowF i1ter 类 卓越 的 普 适 性 令 它 有 点 可 怕 。 

RowFilter<M，I> 类 有 两 个 类 型 参数 : 模型 的 类 型 和 行 标识 符 的 类 型 。 在 处 理 表 格 
时 ， 模 型 总 是 TableModel 的 某 个 子 类 型 ， 而 标识 符 类 型 总 是 Integer。( 在 将 来 的 某 个 
时 刻 ， 其 他 构件 可 能 也 会 支持 行 过 滤 机 制 。 例 如 ， 要 过 滤 JTree 中 的 行 ， 就 可 能 可 以 使 用 
RowFilter <TreeModel, TreePath> 了 。) 

TUE Ae DAL PATTIE : 

public boolean include(RowFilter.Entry<? extends M, ? extends I> entry) 

RowFilter.Entry 类 提供 了 获取 模型 、 行 标识 符 和 给 定 索引 处 的 值 等 内 容 的 方法 ， 因 
此 ， 按 照 行 标 识 符 和 行 的 内 容 都 可 以 进行 过 滤 。 

例如 ， 下 面 的 过 滤器 将 隔行 显示 : 


RowFilter<TableModel, Integer> filter = new RowFilter<TableModel, Integer>() 
public boolean include(Entry<? extends TableModel, ? extends Integer> entry) 
return entry.getIdentifier() % 2 == 0; 
}; 
如 果 想 要 只 包含 那些 具有 偶数 个 卫星 的 行星 ， 可 以 将 上 面 的 测试 条 件 替 换 为 下 面 的 内 容 : 
((Integer) entry.getValue(MOONS COLUMN)) % 2 == 


在 我 们 的 示例 程序 中 ， 人 允许 用 户 隐藏 任意 多 行 , 我们 在 一 个 set 中 存储 了 所 有 隐藏 的 行 
的 索引 。 而 其 中 的 行 过 滤器 将 包含 那些 索引 不 在 这 个 set 中 的 所 有 行 。 

过 滤 机 制 并 不 是 为 那些 过 滤 标准 在 不 时 地 发 生变 化 的 过 滤器 而 设计 的 。 因 此 ， 在 我 们 的 
示例 程序 中 ， 只 要 隐藏 行 的 set 发 生 了 变化 ， 我 们 就 会 调用 下 面 的 语句 : 

sorter. setRowFilter(filter) ; 


过 滤器 一 旦 被 设置 ， 就 会 立即 得 到 应 用 。 

8. 隐藏 和 显示 列 

正如 在 前 一 节 中 看 到 的 ， 可 以 根据 内 容 或 标识 符 来 过 滤 表 格 行 ， 而 隐藏 表格 列 使 用 的 是 
完全 不 同 的 机 制 。 

JTable 类 的 removeColumn 方法 可 以 将 一 列 从 表格 视图 中 移 除 。 该 列 的 数据 实际 上 
并 没有 从 模型 中 移 除 ， 它 们 只 是 在 视图 中 被 隐藏 了 起 来 。removeColumn 方法 接受 一 个 
TableColum 参数 ， 如 果 你 有 的 是 一 个 列 号 (比如 来 自 于 getSelectedColumns 的 调用 结 
采 )， 那 就 需要 问 表 格 模 型 请 求实 际 的 列 对 象 : 


TableColumnModel columnModel = table.getColumnModel () ; 
TableColumn column = columnModel.getColumn(i); 
table. removeColumn (column) ; 


如 果 你 记得 住 该 列 ， 那 么 将 来 就 可 以 再 把 它 添加 回去 : 
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table. addColumn (column) ; 

该 方法 将 该 列 添加 到 表格 的 最 后 面 。 如 果 想 让 它 出 现在 表格 中 的 其 他 任何 地 方 ， 那 么 可 
以 调用 moveColumn 方法 。 

通过 添加 一 个 新 的 TableColumn 对 象 ， 还 可 以 添加 一 个 对 应 于 表格 模型 中 的 一 个 列 索 
引 的 新 列 : 

table.addColumn(new TableColumn (modelColumnIndex)); 

可 以 让 多 个 表格 列 展示 模型 中 的 同一 列 。 


程序 清单 10-7 中 的 程序 展示 了 如 何 选 择 和 过 滤 行 与 列 。 





package tableRowColumn; 


import java.awt.*; 
import java.util.*; 


import javax.swing.*; 
import javax.swing.table.*; 


/** 

10 * This frame contains a table of planet data. 

u */ 

12 public class PlanetTableFrame extends JFrame 

B { 

14 private static final int DEFAULT_WIDTH = 600; 
15 private static final int DEFAULT_HEIGHT = 500; 


17 public static final int COLOR_COLUMN = 4; 
18 public static final int IMAGE_COLUMN = 5; 


20 private JTable table; 

21 private HashSet<Integer> removedRowIndi ces; 

22 private ArrayList<TableColumn> removedColumns; 
23 private JCheckBoxMenultem rowsItem; 

24 private JCheckBoxMenultem columnsItem; 

25 private JCheckBoxMenultem cellsItem; 


27 private String[] columnNames = { "Planet", "Radius", "Moons", "Gaseous", "Color", "Image" }; 


29 private Object[][] cells = { 


30 { "Mercury", 2440.0, 0, false, Color. YELLOW, 

31 new ImageIcon(getClass() .getResource("Mercury.gif")) }, 
32 { "Venus", 6052.0, 0, false, Color. YELLOW, 

33 new ImageIcon(getClass() .getResource("Venus.gif")) }, 
34 { "Earth", 6378.0, 1, false, Color.BLUE, 

35 new ImageIcon(getClass() .getResource("Earth.gif")) }, 
36 { "Mars", 3397.0, 2, false, Color.RED, 

37 new ImageIcon(getClass() .getResource("Mars.gif")) }, 

38 { "Jupiter", 71492.0, 16, true, Color.QRANGE, 


39 new ImageIcon(getClass() .getResource("Jupiter.gif")) }, 
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{ "Saturn", 60268.0, 18, true, Color. ORANGE, 

new ImageIcon(getClass().getResource("Saturn.gif")) }, 
{ "Uranus", 25559.0, 17, true, Color.BLUE, 

new ImageIcon(getClass().getResource("Uranus.gif")) }, 
{ "Neptune", 24766.0, 8, true, Color.BLUE, 

new ImageIcon(getClass() .getResource("Neptune.gif")) }, 
{ "Pluto", 1137.0, 1, false, Color.BLACK, 

new ImageIcon(getClass() .getResource("Pluto.gif")) } }; 


public PlanetTableFrame() 


setS$ize(DEFAULT WIDTH, DEFAULT_HEIGHT) ; 
TableModel model = new DefaultTableModel (cells, columnNames) 
public Class<?> getColumnClass(int c) 


return cells[0] [c] .getClass(); 


} 
j; 


table = new JTable(model); 


table. setRowHei ght (100) ; 
table.getColumnModel () .getCol umn(COLOR_COLUMN) . setMinWidth(250) ; 
table. getColumnModel () .getColumn (IMAGE_COLUMN) . setMi nWidth(100) ; 


final TableRowSorter<TableModel> sorter = new TableRowSorter<>(model) ; 

table.setRowSorter(sorter) ; 

sorter. setComparator(COLOR_COLUMN, Comparator. comparing (Color: :getBlue) 
. thenComparing(Color::getGreen) .thenComparing(Color: :getRed)); 

sorter.setSortable(IMAGE COLUMN, false); 

add(new JScrol]Pane(table), BorderLayout. CENTER) ; 


removedRowIndices = new HashSet<>(); 
removedColumns = new ArrayList<>Q); 


final RowFilter<TableModel, Integer> filter = new RowFilter<TableModel, Integer>() 
public boolean include(Entry<? extends TableModel, ? extends Integer> entry) 


{ 


return !removedRowIndices.contains(entry.getIdentifier()); 
} 
ir 


// create menu 


JMenuBar menuBar = new JMenuBar(); 
setJMenuBar (menuBar) ; 


JMenu selectionMenu = new JMenu("Selection"); 
menuBar.add(selectionMenu) ; 


rowsItem = new JCheckBoxMenultem("Rows") ; 
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94 columnsItem = new JCheckBoxMenuItem("Columns") ; 

95 cellsItem = new JCheckBoxMenuItem("Cells"); 

96 

97 rowsItem. setSelected(table.getRowSel ectionAl lowed()); 

98 columnsItem.setSelected(table.getColumnSelectionAllowed()); 
99 cellsItem.setSelected(table.getCel1SelectionEnabled()) ; 

100 

101 rowsItem.addActionListener(event -> 

102 

103 table.clearSelection(); 

104 table. setRowSelectionAl lowed(rowsItem.isSelected()) ; 
105 updateCheckboxMenul tems () ; 

106 D 

107 

108 columnsItem.addActionListener(event -> 

109 

110 table.clearSelection(); 

111 table.setColumnSelectionAllowed(columnsItem.isSelected()); 
112 updateCheckboxMenul tems () ; 

113 ' 

114 selectionMenu.add(columnsItem) ; 

115 

116 cellsItem.addActionListener(event -> 

117 { 

118 table.clearSelection(); 

119 table.setCel ]SelectionEnabled(cellsItem.isSelected()); 
120 updateCheckboxMenul tems () ; 

121 ); 

122 selectionMenu.add(cellsItem) ; 

123 

124 JMenu tableMenu = new JMenu("Edit") ; 

125 menuBar.add(tabl eMenu) ; 

126 

127 JMenuItem hideColumnsItem = new JMenuItem("Hide Columns"); 
128 hideColumnsItem.addActionListener(event -> 

129 

130 int{] selected = table.getSelectedColumns(); 

131 TableColumnModel columnModel = table.getColumnModel () ; 
132 

133 // remove columns from view, starting at the last 

134 // index so that column numbers aren't affected 

135 

136 for (int i = selected. length - 1; i >= 0; i--) 

137 { 

138 TableColumn column = columnModel .getColumn(selected[i]); 
139 table. removeColumn (column) ; 

140 

141 // store removed columns for "show columns" command 
142 

143 removedColumns.add(column) ; 

144 } 


Ds 
146 tableMenu.add(hideColumnsItem) ; 
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148 JMenuItem showColumnsItem = new JMenuItem("Show Columns"); 

149 showColumnsItem.addActionListener(event -> 

150 { 

151 // restore all removed columns 

152 for (TableColumn tc : removedColumns) 

153 table. addColumn(tc) ; 

154 removedColumns.clear(); 

155 }); 

156 tableMenu.add(showColumnsItem) ; 

157 

158 JMenuItem hideRowsItem = new JMenuItem("Hide Rows"); 

159 hideRowsItem.addActionListener(event -> 

160 { 

161 int[] selected = table.getSelectedRows () ; 

162 for (int i : selected) 

163 removedRowIndices.add(table. convertRowIndexToModel (1)) ; 
164 sorter. setRowFilter(filter); 

165 ae 

166 tableMenu.add(hideRowsItem) ; 

167 

168 JMenuItem showRowsItem = new JMenuItem("Show Rows"); 

169 showRowsItem.addActionListener(event -> 

170 

171 removedRowIndices.clear(); 

172 sorter. setRowFi lter(filter) ; 

173 H); 

174 tableMenu,add (showRowsItem); 

175 

176 JMenuItem printSelectionItem = new JMenuItem("Print Selection"); 
177 printSelectionItem.addActionListener(event -> 

178 { 

179 int[] selected = table.getSelectedRows () ; 

180 System.out.printin("Selected rows: " + Arrays. toString(selected)) ; 
181 selected = table.getSelectedColumns () ; 

182 System.out.printIn("Selected columns: " + Arrays.toString(selected)) ; 
183 Di 

184 tableMenu.add(printSelectionItem) ; 

15 } 


187 private void updateCheckboxMenultems () 


1s { 

189 rowsItem.setSelected(table.getRowSelectionAl lowed()) ; 

190 columnsItem.setSelected(table.getColumnSelectionAl lowed()) ; 
191 cellsItem.setSelected(table.getCel]SelectionEnabled()) ; 





eClass getColumnClass(int columnIndex ) 


获取 该 列 中 的 值 的 类 。 该 信息 用 于 排序 或 绘制 。 
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e TableColumnModel getColumnModel( ) 
获取 描述 表格 列 布局 安排 的 “ 列 模式 ”。 
evoid setAutoResizeMode(int mode) 
设置 自动 更 改 表格 列 大 小 的 模式 。 
参数 : mode AUTO_RESIZE_OFF、 AUTO_RESIZE_NEXT_COLUMN, AUTO_ 
RESIZE_SUBSEQUENT_COLUMNS , AUTO_RESIZE_LAST_COLUMN LJ 
及 AUTO_RESIZE_ALL_COLUMNS 其 中 之 一 
e int getRowMargin( ) 
e void setRowMargin(int margin) 
获取 和 设置 相 邻 行 中 单元 格 之 间 的 间隔 大 小 。 
e int getRowHeight() 
e void setRowHeight(int height) 
获取 和 设置 表格 中 所 有 行 的 默认 高 度 。 
e int getRowHeight(int row) 
e void setRowHeight(int row, int height) 
获取 和 设置 表格 中 给 定 行 的 高 度 。 
e ListSelectionModel getSelectionModel() 
返回 列表 的 选择 模式 。 你 需要 该 模式 以 便 在 行 、 列 以 及 单元 格 之 间 进 行 选择 。 
e boolean getRowSelectionAl1owed( ) 
e void setRowSelectionAllowed(boolean b) 
获取 和 设置 rowSelectionAllowed 属性 。 如 果 为 true， 那 么 当 用 户 点 击 单元 格 的 时 
候 ， 可 以 选 定 行 。 
èe boolean getColumnSelectionAl1owed() 
e void setColumnSelectionAllowed(boolean b) 
获取 和 设置 columnSelectionAllowed 属性 。 如 果 为 true， 那么 当 用 户 点 击 单元 格 
的 时 候 ， 可 以 选 定 列 。 
e boolean getCellSelectionEnabled() 
如 果 既 允许 选 定 行 又 允许 选 定 列 ， 则 返回 true, 
e void setCellSelectionEnabled(boolean b) 
同时 将 rowSelectionA11owed Fi columnSelectionAl lowed 设置 为 b。 
evoid addColumn(TableColumn column) 
向 表格 视图 中 添加 一 列 作为 最 后 一 列 。 
e void moveColumn(int from, int to) 


移动 表格 from 索引 位 置 中 的 列 ， 使 它 的 索引 变 成 to。 该 操作 仅仅 影响 到 视图 。 
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ə void removeColumn(TableColumn column) 
将 给 定 的 列 从 视图 中 移 除 。 

e int convertRowIndexToModel(int index) 6 

eint convertColumnIndexToModel(int index) 

返回 具有 给 定 索 引 的 行 或 列 的 模型 索引 ， 这 个 值 与 行 被 排序 和 过 滤 ， 以 及 列 被 移动 和 
移 除 时 的 索引 不 同 。 


e void setRowSorter(RowSorter<? extends TableModel> sorter) 


设置 行 排序 器 。 





e TableColumn getColumn(int index) 


获取 表格 的 列 对 象 ， 用 于 描述 给 定 罕 引 的 列 。 





e TableColumn(int modelColumnIndex) 
构建 一 个 表格 列 ， 用 以 显示 给 定 索引 位 置 上 的 模型 列 。 
evoid setPreferredWidth(int width) 
e void setMinWidth(int width) 
e void setMaxWidth(int width) 
将 表格 的 首选 宽度 、 最 小 宽度 以 及 最 大 宽度 设置 为 width。 
e void setWidth(int width) 
设置 该 列 的 实际 宽度 为 width。 
e void setResizable(boolean b) 


如 果 b 为 true， 那 么 该 列 可 以 更 改 大 小 。 





e void setSelectionMode(int mode) 
参数 . mode SINGLE_SELECTION, SINGLE_INTERVAL_SELECTION 以 及 MULTIPLE_ 
INTERVAL_SELECTION 其 中 之 一 





e void setComparator(int column, Comparator<?> comparator) 


BC BE FY HBA o 


e void setSortable(int column, boolean enabled) 


使 对 给 定 列 的 排序 可 用 或 禁用 。 


e void setRowFilter(RowFilter<? super M,? super I> filter) 
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e void setStringConverter(TableStringConverter stringConverter ) 
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e abstract String toString(TableModel model, int row, int column) 


将 给 定位 置 的 模型 值 转换 为 字符 串 ， 你 可 以 覆盖 这 个 方法 。 
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e boolean include(RowFilter.Entry<? extends M,? extends I> entry) 


指定 要 保留 的 行 ， 你 可 以 履 关 这 个 方法 。 


e static <M,I> RowFilter<M,I> numberFilter(RowFilter.ComparisonType 


type, Number number, int...indices) 

estatic <M,I> RowFilter<M,I> dateFilter(RowFilter.ComparisonType 
type, Date date, int... indices) 
返回 一 个 过 滤器 ， 它 包含 的 行 是 那些 与 给 定 的 数字 或 日 期 进行 给 定 比较 后 匹配 的 行 。 
比较 类 型 是 EQUAL 、NOT_EQUAL AFTER 或 BEFORE 之 一 。 如 果 给 定 了 列 模型 索引 ， 
则 只 搜索 这 些 列 。 否 则 ， 将 搜索 所 有 列 。 对 于 数字 过 滤器 ， 单 元 格 的 值 所 属 的 类 必须 
与 给 定数 字 的 类 匹配 。 

e static <M,I> RowFilter<M,I> regexFilter(String regex, int... indices) 
返回 一 个 过 滤器 ， 它 包含 的 行 含 有 与 给 定 的 正则 表达 式 匹 配 的 字符 串 。 如 果 给 定 了 
列 模型 索引 ， 则 只 搜索 这 些 列 。 否 则 ， 将 搜索 所 有 列 。 注 意 ，RowFilter.Entry 的 
getStringValue 方法 返回 的 字符 串 是 匹配 的 。 


e static <M,I> RowFilter<M,I> andFilter(Iterable<? extends RowFilter<? 
super M,? super I>> filters) 
è static <M,I> RowFilter<M,I> orFilter(Iterable<? extends RowFilter<? 
super M,? super I>> filters) 
BRE — ANE, ERS EAE a EBT A a BD al Ea a PT 
e static <M,I> RowFilter<M,I> notFilter(RowFilter<M,I> filter) 
返回 一 个 过 滤 希 ， 它 包含 的 项 是 那些 不 包含 在 给 定 过 滤 天 中 的 项 。 
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eI getIdentifier() 
返回 这 个 行 的 标识 第 

eM getModel() 
返回 这 个 行 的 模型 。 
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e Object getValue(int index) 
B EXAT a FER AF BY TL 
e int getValueCount( ) 
返回 在 这 个 行 中 存储 的 值 的 数量 。 
e String getStringValue() 
返回 在 这 个 行 的 给 定 索 引 处 存储 的 值 转换 成 的 字符 串 。 由 TableRowSorter 产生 的 项 
的 getStringValue 方法 会 调用 排序 器 的 字符 串 转换 器 。 


10.2.4 单元 格 的 绘制 和 编辑 


正如 在 10.2.3 节 中 看 到 的 ， 列 的 类 型 确定 了 单元 格 应 该 如 何 绘制 。Boolean 和 Icon 类 
型 有 默认 的 绘制 项 ， 它 们 将 绘制 复 选 框 或 图 标 ， 而 对 于 其 他 所 有 类 型 ， 都 需要 安装 定制 的 绘 
MAF o 

1. 绘制 单元 格 

表格 的 单元 格 绘制 器 与 你 在 前 面 看 到 的 列表 单元 格 绘制 器 类 似 。 它 们 都 实现 了 
TableCell Renderer 接口 ， 并 只 有 一 个 方法 


Component getTableCellRendererComponent(JTable table, Object value, boolean isSelected, 
boolean hasFocus, int row, int column) 


该 方法 在 表格 需要 绘制 一 个 单元 格 的 时 候 被 调用 。 它 会 返回 一 个 构件 ， 接 着 该 构件 的 
paint 方法 会 被 调用 ， 以 填充 单元 格 区 域 。 

在 图 10-12 中 的 表格 包含 类 型 为 Color 的 单元 格 ， 绘 制 器 直接 返回 一 个 面板 ， 其 背景 颜 
色 设 置 为 存储 在 该 单元 格 中 的 颜色 对 象 ， 该 颜色 是 作为 value 参数 传递 的 。 

class ColorTableCellRenderer extends JPanel implements TableCellRenderer 


public Component getTableCel]RendererComponent (JTable table, Object value, 
boolean isSelected, boolean hasFocus, int row, int column) 


setBackground((Color) value); 
if (hasFocus) 
setBorder (UIManager.getBorder("Table. focusCel lHighlightBorder")) ; 
else 
setBorder(null); 
return this; 
} 
正如 你 看 到 的 那样 ， 当 该 单元 格 获得 焦点 的 时 候 ， 绘 制 咒 会 安装 一 个 边框 。( 我 们 可 以 回 
UIManager 寻求 合适 的 边框 。 为 了 发 现 查找 的 关键 所 在 ， 我 们 可 以 深入 DefaultTableCe11 
Renderer 类 的 源码 内 部 看 个 究竟 。) 
通常 情况 下 ， 你 可 能 还 想 设置 单元 格 的 背景 颜色 ， 以 指示 当前 是 否 选 中 了 它 。 这 里 我 们 跳 
过 这 步 ， 因 为 它 会 与 我 们 现在 讨论 的 显示 颜色 混在 一 起 。 程 序 清单 10-4 中 的 ListRenderingTest 
示例 展示 了 怎样 在 一 个 绘制 器 中 指示 选择 状态 。 
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GY 提示 : 如 果 你 的 绘制 器 只 是 绘制 一 个 文本 字符 串 或 者 一 个 图 标 ， 那么 可 以 继承 
DefaultTableCellRenderer 这 个 类 。 该 类 会 负责 绘制 焦点 和 选择 状态 。 





你 必须 告诉 表格 要 使 用 这 个 绘制 器 去 绘制 所 有 类 型 为 Color 的 对 象 。JTable 类 的 
setDefaultRenderer 方法 可 以 让 你 建立 它们 之 间 的 这 种 联系 。 你 需要 提供 一 个 Class 对 
象 和 绘制 侨 。 

table.setDefaultRenderer(Color.class, new ColorTableCellRenderer()); 

现在 这 个 绘制 器 就 可 以 用 于 表格 中 具有 给 定 类 型 的 所 有 对 象 了 。 

如 果 想 要 基于 其 他 标准 选择 绘制 器 ， 则 需要 从 JTable RPP RPA, HO ie 
getCellRender 方法 。 

2. 绘制 表 头 

为 了 在 表 头 中 显示 图 标 ， 需 要 设置 表 头 值 。 


moonColumn.setHeaderValue(new ImageIcon("Moons.gif")); 


Ri, ZEA A AEB AT Wek AE TP Se la, A, Beil aes BP 
装 。 例 如 ， 要 在 列 头 显示 图 像 图 标 ， 可 以 调用 : 


moonColumn, setHeaderRenderer(table.getDefaul tRenderer(ImageIcon.class)) ; 


3. 单元 格 编辑 

为 了 使 单元 格 可 编辑 ， 表 格 模 型 必须 通过 定义 isce11Editable 方法 来 指明 哪些 单元 格 
是 可 编辑 的 。 最 常见 的 情况 是 ， 你 可 能 想 使 某 几 列 可 编辑 。 在 这 个 示例 程序 中 ， 我 们 允许 对 
表格 中 的 四 列 进行 编辑 。 

‘ion boolean isCellEditable(int r, int c) 


} 


return c == PLANET_COLUMN || c == MOONS COLUMN || c == GASEQUS_COLUMN || c == COLOR_COLUMN; 
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注意 : AbstractTableModel 定义 的 isCellEditable 方法 总 是 返回 false, DefaultTable 
Model 覆盖 了 该 方法 以 便 总 是 返回 true。 
运行 一 下 程序 清单 10-8 到 程序 清单 10-11 的 程序 就 会 注意 到 ， 可 以 点 击 Gaseous 列 中 的 
复 选 框 ， 并 能 选中 或 取消 复 选 标记 。 如 果 点 击 Moons 列 中 的 某 个 单元 格 ， 就 会 出 现 一 个 组 合 
HE (参见 图 10-13 )。 你 很 快 就 会 看 到 怎样 将 这 样 一 个 组 合 框 作为 一 个 单元 格 编辑 器 安装 到 表 
格 上 。 


fF TableCellRendertest 





图 10-13 单元 格 编辑 器 


最 后 ， 点 击 第 一 列 中 的 某 个 单元 格 ， 该 单元 格 就 会 获取 焦点 。 你 就 可 以 开始 键 人 数据 ， 
而 该 单元 格 的 内 容 也 会 随 之 更 改 。 

你 刚刚 看 到 的 是 DefaultcellEditor 类 的 三 种 变型 。Defau1ltCce11Editor 可 以 用 
JTextField, JCheckBox 或 者 JComboBox 来 构造 。JTable 类 会 自动 为 Boolean 类 型 的 
单元 格 安装 一 个 复 选 框 编辑 器 ， 并 为 所 有 可 编辑 的 、 但 未 提供 它们 自己 的 绘制 器 的 单元 格 安 
装 一 个 文本 编辑 器 。 文 本 框 可 以 让 用 户 去 编辑 那些 对 表格 模型 get ValueAt 方法 的 返回 值 执 
ÍT toString 操作 而 产生 的 字符 串 。 

一 旦 编辑 完成 ， 通 过 调用 编辑 器 的 getCel lEditorValue 方法 就 可 以 读 取 编辑 过 的 值 。 
该 方法 应 该 返回 一 个 正确 类 型 的 值 (也 就 是 模型 的 getColumnType 方法 返回 的 类 型 )。 

为 了 获得 一 个 组 合 框 编辑 咒 ， 你 需要 手动 设置 单元 格 编辑 器 ， 因 为 JTable 构件 并 不 知 
道 什么 样 的 值 对 某 一 特殊 类 型 来 说 是 适合 的 。 对 于 Moons 列 来 说 ， 我 们 希望 可 以 让 用 户 选 择 
0 ~ 20 之 间 的 任何 值 。 下 面 是 对 组 合 框 进行 初始 化 的 代码 。 


JComboBox moonCombo = new JComboBox(); 
for (int i = 0; i <= 20; i++) 
moonCombo. addItem(7) ; 


为 了 构造 一 个 DefaultCe11Editor， 需 要 在 该 构造 器 中 提供 一 个 组 合 框 。 


TableCellEditor moonEditor = new DefaultCellEditor(moonCombo) ; 
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接 下 来 ， 我 们 需要 安装 这 个 编辑 器 。 与 颜色 单元 格 绘制 器 不 同 ， 这 个 编辑 器 不 依赖 于 对 
象 类 型 ， 我 们 未 必 想 要 把 它 作用 于 类 型 为 Integer 的 所 有 对 象 上 。 相 反 地 ， 我 们 需要 把 它 
安装 到 一 个 特定 列 中 : 

moonColumn. setCellEditor (moonEdi tor) ; 

4. 定制 编辑 器 

再 次 运行 一 下 示例 程序 并 点 击 一 种 颜色 。 这 时 会 弹出 一 个 颜色 选择 器 让 你 为 行星 选择 一 
种 新 颜色 。 选 中 一 种 颜色 ， 然 后 点 击 OK。 单 元 格 颜 色 就 会 随 之 更 新 (参见 图 10-14). 


一 
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颜色 进行 编 

颜色 单元 格 编辑 器 并 不 是 一 种 标准 的 表格 单元 格 编辑 器 ， 而 是 一 种 定制 实现 的 编辑 谷 。 
为 了 创建 一 个 定制 的 单元 格 编辑 器 ， 需 要 实现 TableCellEditor 接口 。 这 个 接口 有 扣 拖 珍 
TK, M Java SE 1.3 开始 ， 提 供 了 AbstractCellEditor 类 ， 用 于 负责 事件 处 理 的 细 廊 。 

TableCe11Editor 接口 的 getTableCe11EditorComponent 方法 请 求 某 个 构件 去 绘制 单元 格 。 
除了 没有 focus 参数 之 外 ， 它 和 TableCe11Renderer 接口 的 getTableCel 1RendererComponent 
方法 极为 相似 。 因 为 我 们 要 编辑 单元 格 ， 所 以 我 们 假设 它 获 得 了 焦点 。 在 编辑 过 程 中 ， 编 辑 
器 构件 会 暂时 取代 绘制 器 。 在 我 们 的 示例 中 ， 我 们 返回 的 是 一 个 没有 颜色 的 空 面 板 。 这 只 是 
告诉 用 户 该 单元 格 正在 被 编辑 。 

接 下 来 ， 当 用 户 点 击 单元 格 时 ， 你 希望 能 弹出 你 自己 的 编辑 侣 。 

JTable 类 用 一 个 事件 (例如 鼠标 点 击 ) 去 调用 你 的 编辑 器 ， 以 便 确定 该 事件 是 否 可 以 被 
接受 去 启动 编辑 过 程 。AbstractCe11Editor 将 该 方法 定义 为 能 够 接收 所 有 的 事件 类 型 。 
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public boolean isCellEditable(EventObject anEvent) 
{ 


return true; 


然而 ， 如 果 你 将 该 方法 覆盖 成 fa1se， 那 么 表格 模型 就 不 会 遇 到 插入 编辑 器 构件 这 样 的 
PIR T o 

HRR T RAE, BERERE, BBA shouldSelectCell Fy 
法 束 会 补 调 用 。 应 该 在 这 个 方法 中 启动 编辑 过 程 ， 例 如 ， 弹 出 一 个 外 部 的 编辑 对 话 框 。 

public boolean shouldSelectCell (EventObject anEvent) 


colorDialog.setVisible(true) ; 
return true; 


如 采用 户 取 消 编辑 ， 表 格 会 调用 cancelCellediting 方法 。 如 果 用 户 已 经 点 击 了 另 一 
个 表格 单元 ， 那 么 表格 会 调用 stopCe11Editing 方法 。 在 这 两 种 情况 中 ， 你 都 应 该 将 对 话 
框 隐藏 起 来 。 当 stopCe11Editing 方 法 被 调用 时 ， 表 格 可 能 会 使 用 被 部 分 编辑 的 值 。 如 果 
当前 值 有 效 ， 那 么 应 该 返回 true。 在 颜色 选择 器 中 ,任何 值 都 是 有 效 的 。 但 是 如 果 编 辑 的 
是 其 他 数据 ， 那 么 应 该 保证 只 有 有 效 的 数据 才能 从 编辑 器 中 读 取 出 来 。 

男 外 ， 应 该 调用 超 类 的 方法 ， 以 便 进行 事件 的 触发 ， 否 则 ， 编 辑 事 件 就 无 法 正确 地 
取消 。 

public void cancelCellEditing() 


colorDialog.setVisible(false) ; 
super.cancelCellEditing(); 


最 后 ， 必 须 提供 一 个 方法 ， 以 便 产 生 用 户 在 编辑 过 程 中 所 提供 的 值 。 
public Object getCel Edi torValue() 


return colorChooser.getColor(); 


总 结 一 下 ， 你 的 定制 编辑 器 应 该 遵循 下 面 几 点 : 

1 ) 继承 AbstractCellEditor 类 ， 并 实现 TableCellEditor 接口 。 

2) 定义 getTableCel11EditorComponent 方法 以 提供 一 个 构件 。 它 可 以 是 一 个 哑 构 件 
(如 有 果 你 弹出 一 个 对 话 框 ) 或 者 是 适当 的 编辑 构件 ， 例 如 复 选 框 或 文本 框 。 

3) 定义 shouldSelectCce11、stopCe11Editing 及 cance1Cce11Editing 方 法 ， 来 
处 理 编辑 过 程 的 启动 、 完 成 以 及 取消 。stopCe11Editing 和 cance1Cce11 Editing 方法 应 
该 凋 用 超 类 方法 以 保证 监听 器 能 够 接收 到 通知 。 

4) 定义 getCellEditorValue 方法 返回 编辑 结果 的 值 。 

最 后 ， 通 过 调用 stopCellEditing 和 cancelCe11 Editing 方法 ， 以 表明 用 户 什 么 时 
间 完 成 了 编辑 操作 。 在 构建 颜色 对 话 框 的 时 候 ， 我 们 安装 了 接受 和 取消 的 回调 ， 用 于 触发 这 
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些 事件 。 


colorDialog = JColorChooser.createDialog(null, "Planet Color", false, colorChooser, 
EventHandler.create(ActionListener.class, this, "stopCellEditing"), 
EventHandler.create(ActionListener.class, this, "cancelCellEditing")) ; 


这 样 就 完成 了 定制 编辑 器 的 实现 过 程 。 

你 现在 已 经 知道 了 怎样 使 一 个 单元 格 可 编辑 ， 以 及 怎样 安装 一 个 编辑 器 。 还 剩 下 一 个 问 
题 ， 即 怎样 使 用 用 户 编辑 过 的 值 来 更 新 表格 模型 。 当 编辑 完成 的 时 候 ，JTab1e 类 会 调用 表 
格 模型 的 下 面 这 个 方法 : 

void setValueAt(Object value, int r, int c) 

需要 将 这 个 方法 覆盖 掉 以 便 存 储 新 值 。va1ue 参数 是 单元 格 编辑 器 返回 的 对 象 。 如 采 实 
现 了 单元 格 编辑 器 ， 那 么 你 就 知道 从 getCe11EditorValue 方法 返回 的 是 什么 类 型 的 对 象 。 
在 DefaultCe11Editor 这 种 情况 中 ， 这 个 值 有 三 种 可 能 : 如 果 单 元 格 编辑 器 是 复 选 枉 ， 那 
么 它 就 是 Boolean 值 ;如果 是 一 个 文本 框 ， 那 么 它 就 是 一 个 字符 串 ; 如 果 这 个 值 来 源 于 组 合 
框 ， 那 么 就 是 用 户 选 定 的 对 象 。 

如 果 value 对 象 不 具有 合适 的 类 型 ， 那 么 需要 对 它 进 行 转换 。 例 如 ， 在 一 个 文本 框 中 编 
名 一 个 数字 ， 这 种 情况 最 常 发 生 。 在 我 们 的 示例 中 ,我们 是 将 组 合 框 组装 成 了 Integer 对 象 ， 
所 以 不 需要 任何 转换 。 





package tableCellRender; 


import java.awt.*; 
import javax.swing.*; 
import javax.swing.table.*; 


/** 

* This frame contains a table of planet data. 

* 
10 public class TableCellRenderFrame extends JFrame 
“a. 4 
12 private static final int DEFAULT_WIDTH = 600; 
13. private static final int DEFAULT_HEIGHT = 400; 
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15 public TableCellRenderFrame() 


{ 
17 setSize(DEFAULT_WIDTH, DEFAULT_HEIGHT) ; 


19 TableModel model = new PlanetTableModel () ; 

20 JTable table = new JTable(model); 

21 table. setRowSelectionAl lowed (false) ; 

22 

23 // set up renderers and editors 

24 

25 table.setDefaultRenderer(Color.class, new ColorTableCellRenderer()) ; 


26 table. setDefaultEditor(Color.class, new ColorTableCellEditor()); 
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28 JComboBox<Integer> moonCombo = new JComboBox<>(); 

29 for (int i = 0; i <= 20; i++) 

30 moonCombo.addItem(i) ; 

31 

32 TableColumnModel columnModel = table.getColumnModel (); 

33 TableColumn moonColumn = columnModel .getColumn(PlanetTabl eModel .MOONS COLUMN) : 
34 moonColumn.setCel1Editor(new Defaul tCel1Editor(moonCombo)) : 

35 moonColumn. setHeaderRenderer (table. getDefaul tRenderer(ImageIcon.class)); 

36 moonColumn, setHeaderValue (new Imagelcon(getClass() .getResource("Moons.gif"))); 
37 

38 // show table 

39 

40 table. setRowHei ght (100) ; 

41 add(new JScrol]Pane(table), BorderLayout.CENTER); 

42 } 





package tableCellRender; 


import java.awt.*; 
import javax.swing.*; 
import javax.swing.table.*: 


/** 

* The planet table model specifies the values, rendering and editing properties for the planet 
* data, 
"y 

11 public class PlanetTableModel extends AbstractTableModel 

n { 

13 public static final int PLANET COLUMN = 0; 

14 public static final int MOONS COLUMN = 2: 

15 public static final int GASEOUS COLUMN = 3; 

16 public static final int COLOR_COLUMN = 4: 


OO a ~ es am 和 UN 和 


— 
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18 private Object[][] cells = { 


19 { "Mercury", 2440.0, 0, false, Color. YELLOW, 

20 new ImageIcon(getClass().getResource("Mercury.gif")) }, 
21 { "Venus", 6052.0, 0, false, Color. YELLOW, 

22 new ImageIcon(getClass().getResource("Venus.gif")) }, 
23 { "Earth", 6378.0, 1, false, Color.BLUE, 

24 new ImageIcon(getClass().getResource("Earth.gif")) }, 
25 { "Mars", 3397.0, 2, false, Color.RED, 

26 new ImageIcon(getClass().getResource("Mars.gif")) }, 

27 { "Jupiter", 71492.0, 16, true, Color. ORANGE, 

28 new ImageIcon(getClass().getResource("Jupiter.gif")) }, 
29 { "Saturn", 60268.0, 18, true, Color.ORANGE, 

30 new ImageIcon(getClass().getResource("Saturn.gif")) }, 
31 { "Uranus", 25559.0, 17, true, Color. BLUE, 

32 new ImageIcon(getClass().getResource("Uranus.gif")) }, 


33 { "Neptune", 24766.0, 8, true, Color.BLUE, 
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34 new ImageIcon(getClass() .getResource("Neptune.gif")) }, 
35 { "Pluto", 1137.0, 1, false, Color.BLACK, 
36 new ImageIcon(getClass().getResource("Pluto.gif")) } }; 


" " " " 


38 private String[] columnNames = { "Planet", "Radius", "Moons", "Gaseous", "Color", "Image" }; 
40 public String getColumnName(int c) 


42 return columnNames [c] ; 


43 } 
a5 public Class<?> getColumnClass(int c) 


{ 
47 return cells[0] [c] .getClass(); 
4 


so public int getColumnCount () 


{ 
52 return cells{0]. length; 
53 } 


ss public int getRowCount() 


57 return cells. length; 


58 } 
so public Object getValueAt(int r, int c) 


62 return cells[r] [c]; 


63 } 


65 public void setValueAt(Object obj, int r, int c) 


{ 
67 cells[r] [c] = obj; 
} 


70 public boolean isCellEditable(int r, int c) 


11 { 

n return c == PLANET_COLUMN || c == MOONS_COLUMN || c == GASEOUS_COLUMN || c == COLOR_COLUMN; 
23 } 

7 } 





package tableCel]Render; 


import java.awt.*; 
import javax.swing.*; 
import javax.swing. table. *; 


/** 


* This renderer renders a color value as a panel with the given color. 


či 
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10 public class ColorTableCellRenderer extends JPanel implements TableCe]]Renderer 


u { 

12 public Component getTableCel]RendererComponent (JTable table, Object value, boolean isSelected, 
13 boolean hasFocus, int row, int column) 

14 { 

15 setBackground((Color) value); 

16 if (hasFocus) setBorder(UIManager.getBorder("Table.focusCel 1HighlightBorder")) ; 

17 else setBorder(null); 

18 return this; 

19 } 

20 } 





package tableCel]Render; 


1 

2 

3 import java.awt.*; 

4 import java.awt.event.*: 

5 import java.beans.*; 

6 import java.util.*; 

7 import javax.swing.*; 

8 import javax.swing.table.*; 
9 


10 /** 
11 * This editor pops up a color dialog to edit a cell value, 
2 */ 


13 public class ColorTableCellEditor extends AbstractCellEditor implements TableCellEditor 
14 { 

15 private JColorChooser colorChooser; 

16 private JDialog colorDialog; 

17 private JPanel panel; 


19 public ColorTableCellEditor() 


20 { 

21 panel = new JPanel (); 

22 // prepare color dialog 

23 

24 colorChooser = new JColorChooser(); 

25 colorDialog = JColorChooser.createDialog(null, "Planet Color", false, colorChooser, 

26 EventHandler.create(ActionListener.class, this, "stopCellEditing"), 

27 EventHandler.create(ActionListener.class, this, "cancelCellEditing")); 

28 } 

29 

30 public Component getTableCellEditorComponent (JTable table, Object value, boolean isSelected, 
31 int row, int column) 

32 { 

33 // this is where we get the current Color value. We store it in the dialog in case the user 
34 // starts editing 

35 colorChooser.setColor((Color) value); 

36 return panel; 

37 } 


39 public boolean shouldSelectCell (EventObject anEvent) 
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40 { 

41 // start editing 

42 colorDialog.setVisible(true) ; 

43 

44 // tell caller it is ok to select this cell 
45 return true; 

46 } 

47 

48 public void cancelCellEditing() 

49 { 

50 // editing is canceled--hide dialog 
51 colorDialog.setVisible(false) ; 

52 super.cancelCel lEditing() ; 

53 } 

54 

55 public boolean stopCellEditing() 

56 { 

57 // editing is complete--hide dialog 
58 colorDialog.setVisible(false) ; 

59 super. stopCel 1Editing(); 

60 

61 // tell caller is is ok to use color value 
62 return true; 

63 } 


65 public Object getCel1Edi torValue() 


67 return colorChooser.getColor(); 





èe TableCellRenderer getDefaultRenderer(Class<?> type) 


BRA A ERY BY BRA Ze MAF o 
e TableCellEditor getDefaultEditor(Class<?> type) 


RL EE) BRA Sa AF 





e Component getTableCel1lRendererComponent(JTable table, Object value, 
boolean selected, boolean hasFocus, int row, int column) 


返回 一 个 构件 ， 它 的 paint 方法 将 被 调用 以 便 绘制 一 个 表格 单元 格 。 


参数 : table 该 表格 包含 要 绘制 的 单元 格 
value 要 绘制 的 单元 格 
selected 如 果 该 单元 格 当前 已 被 选中 ， 则 为 true 
hasFocus 如 果 该 单元 格 当 前 具有 焦点 ， 则 为 true 


row, column 单元 格 的 行 及 列 





516 Java ZSRR All BAHH 





e void setCellEditor(TableCellEditor editor) 
èe void setCellRenderer(TableCellRenderer renderer) 


为 该 列 中 的 所 有 单元 格 设置 单元 格 编辑 器 或 绘制 器 。 


evoid setHeaderRenderer(TableCellRenderer renderer) 


为 该 列 中 的 所 有 表 头 单元 格 设置 单元 格 绘制 器 。 


e void setHeaderValue(Object value) 


为 该 列 中 的 表 头 设置 用 于 显示 的 值 。 











e DefaultCellEditor( JComboBox comboBox ) 
构建 一 个 单元 格 编辑 器 ， 并 以 一 个 组 合 框 的 形式 显示 出 来 ， 用 于 选择 单元 格 的 值 。 





eComponent getTableCellEditorComponent(JTable table, Object value, 
boolean selected, int row, int column) 
返回 一 个 构件 ， 它 的 paint 方法 用 于 绘制 表格 的 单元 格 。 
参数 : table 包含 要 绘制 的 单元 格 的 表格 
value 要 绘制 的 单元 格 
selected 如 采 该 单元 格 已 被 当前 选中 ， 则 为 true 
row,colum 单元 格 的 行 及 列 





e boolean isCellEditable(EventObject event) 
如 果 该 事件 能 够 启动 对 该 单元 格 的 编辑 过 程 ， 那 么 返回 true. 

e boolean shouldSelectCell(EventObject anEvent) 
局 动 编辑 过 程 。 如 果 被 编辑 的 单元 格 应 该 被 选中 ， 则 返回 true。 通 常情 况 下 ， 你 希望 
返回 的 是 true， 不 过 ， 如 果 你 不 希望 在 编辑 过 程 中 改变 单元 格 被 选中 的 情况 ， 那 么 你 
可 以 返回 false, 

e void cancelCellEditing() 
取消 编辑 过 程 。 你 可 以 放弃 已 进行 了 部 分 编辑 的 操作 。 

e boolean stopCellEditing() 
出 于 使 用 编辑 结果 的 目的 ， 停 止 编 辑 过 程 。 如 果 被 编辑 的 值 对 读 取 来 说 处 于 适合 的 状 
态 ， 则 返回 true。 

e Object getCellEditorValue() 
返回 编辑 结果 。 
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evoid addCellEditorListener(CellEditorListener 1) 
èe void removeCellEditorListener(CellEditorListener 1) 


添加 或 移 除 必需 的 单元 格 编辑 器 的 监听 器 。 


10.3 树 


每 个 使 用 过 分 层 结构 的 文件 系统 的 计算 机 用 户 都 见 过 树 状 显示 。 当 然 ， 目 录 和 文件 形式 
仅仅 是 树 状 组 织 结构 中 的 一 种 。 日 常生 活 中 还 有 很 多 这 样 的 树 结构 ， 例如 国家 、 州 以 及 城市 
之 间 的 层次 结构 ， 如 图 10-15 所 示 。 
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图 10-15 国家 、 州 及 城市 的 层次 结构 
作为 一 名 编程 人 员 ， 我 们 经 常 需要 显示 这 些 树 形 结构 。 幸 运 的 是 ，Swing 类 库 中 有 一 个 


正 是 用 于 此 目的 的 JTree 类 。JTree 类 (以 
及 它 的 辅助 类 ) 负责 布局 树 状 结构 ， 按 照 用 户 
请 求 展开 或 折 秋 树 的 节点 。 在 本 节 中 ， 我 们 
将 介绍 怎样 使 用 JTree 类 。 

与 其 他 复杂 的 Swing 构件 一 样 ， 我 们 必须 
集中 介绍 一 些 常用 方法 ， 无 法 涉及 所 有 的 细节 。 
如 果 读 者 想 获得 与 众 不 同 的 效果 ， 我 们 推荐 你 
参考 David M. Geary 撰写 的 《 Graphic Java 》( 第 
3 版 )，Kim Topley 编写 的 《 Core Swing 》。 

在 我 们 深入 展开 之 前 ， 先 介绍 一 些 术 语 
(参见 图 10-16 )。 一 棵 树 由 一 些 节 点 (node) . 图 10-16 树 中 的 术语 
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组 成 。 每 个 节点 要 人 么 是 叶 节 点 〈leaf) 要 么 是 有 和 孩子 节点 (child node) 的 节点 。 除 了 根 节 点 
(root node )， 每 一 个 节点 都 有 一 个 唯一 的 父 节 点 (parent node)。 一 棵 树 只 有 一 个 根 节点 。 有 
时 ， 你 可 能 有 一 个 树 的 集合 ， 其 中 每 棵 树 都 有 自己 的 根 节点 。 这 样 的 集合 称 作 森 林 (forest). 


10.3.1 简单 的 树 


在 第 一 个 示例 程序 中 ， 我 们 仅仅 展示 了 一 个 具有 几 个 节点 的 树 (参见 图 10-18 )。 如 
同 大 多 数 Swing 构件 一 样 ， 只 要 提供 一 个 数据 模型 ， 构 件 就 可 以 将 它 显示 出 来 。 为 了 构建 
JTree， 需 要 在 构造 器 中 提供 这 样 一 个 树 模型 : 


TreeModel mode] = ait 
JTree tree = new JTree(hodel) 


注意 : 还 有 一 些 构造 器 可 以 用 一 些 元 素 的 集合 来 构建 树 。 


JTree(Object[] nodes) 
JTree(Vector<?> nodes) 
JTree(Hashtable<?, ?> nodes) // the values become the nodes 


这 些 构造 器 不 是 特别 有 用 。 它 们 仅仅 是 创建 出 一 个 包含 了 若干 棵 树 的 森林 ， 其 中 每 
棵 树 只 有 一 个 节点 。 第 三 个 构造 器 显得 特别 没 用 ， 因 为 这 些 节点 实际 的 显示 次 序 是 由 键 
的 散 列 码 确 定 的 。 


怎样 才能 获得 一 个 树 模 型 呢 ? 可 以 通过 创建 一 个 实现 了 TreeModel1 接口 的 类 来 构建 自 
己 的 树 模型 。 在 本 章 的 后 面部 分 ， 将 会 介绍 应 该 如 何 实现 。 现 在 ， 我 们 仍 坚 持 使 用 Swing 类 
库 提 供 的 DefaultTreeMode1 模型 。 

为 了 构建 一 个 默认 的 树 模 型 ， 必 须 提 供 一 个 根 节 点 。 


TreeNode root = . 
DefaultTreeModel aie = new DefaultTreeModel (root) ; 


TreeNode 是 另外 一 个 接口 。 可 以 将 任何 实现 了 这 个 接口 的 类 的 对 象 组 装 到 默认 的 树 模 型 
中 。 这 里 ， 我 们 使 用 的 是 Swing 提供 的 具体 节点 类 ， 叫 做 DefaultMutab1leTreeNode。 这 个 
类 实现 了 MutableTreeNode 接口 ， 该 接口 是 TreeNode 的 一 个 子 接口 (参见 图 10-17). 

任何 一 个 默认 的 可 变 树 节点 都 存放 着 一 个 对 象 ， 即 用 户 对 象 (user object)。 树 会 为 所 有 
的 方 态 绘制 这 些 用 户 对 象 。 除 非 指 定 一 个 绘制 器 ， 否 则 树 将 直接 显示 执行 完 toString 方法 
之 后 的 结果 字符 串 。 

在 第 一 个 示例 程序 中 ， 我 们 使 用 了 字符 串 作为 用 户 对 象 。 实 际 应 用 中 ， 通 常会 在 树 中 组 
装 更 具 表 现 力 的 用 户 对 象 。 例 如 ， 当 显示 一 个 目录 树 时 ， 将 Fil1e 对 象 用 于 节点 将 具有 实际 
意义 。 

可 以 在 构造 带 中 设 定 用 户 对 象 ， 也 可 以 稍 后 在 setUserObject 方法 中 设 定 用 户 对 象 : 


DefaultMutableTreeNode node = new DefaultMutableTreeNode("Texas") ; 


node. setUserObject ("Cali fornia’) ; 
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10-17 有 关 树 的 类 
接 下 来 ， 可 以 建立 节点 之 间 的 父 / 子 关系 。 从 根 节 点 开始 ， 使 用 add 方法 来 添加 子 节 点 : 


DefaultMutableTreeNode root = new DefaultMutableTreeNode("World"); 
DefaultMutableTreeNode country = new DefaultMutableTreeNode ("USA") ; 


root.add(country) ; #1 Simpletree 
DefaultMutableTreeNode state = new DefaultMutableTreeNode("Cali fornia"); 

country.add(state) ; it aiiin 
图 10-18 显示 了 这 棵 树 的 外 观 。 eo 


按照 这 种 方式 将 所 有 的 节点 链接 起 来 。 然 后 用 根 节点 构 | Toe 
建 一 个 DefaultTreeMode1。 最 后 ， 用 这 个 树 模型 构建 一 个 We 








Jtree, 


图 10-18 一 棵 简单 的 树 
DefaultTreeModel treeModel = new DefaultTreeModel (root) ; 


JTree tree = new JTree(treeModel) ; 


或 者 ， 使 用 快捷 方式 ， 直 接 将 根 节点 传递 给 Jtree 构造 器 。 那 么 这 棵 树 就 会 自动 构建 一 个 默 
认 的 树 模 型 : 


JTree tree = new JTree(root); 


程序 清单 10-12 给 出 了 完整 的 代码 。 





1 package tree; 
2 
3 Import javax.swing.*; 
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4 import javax.swing.tree.*; 

5 

6 /** 

7 * This frame contains a simple tree that displays a manually constructed tree model. 
a */ 

9 public class SimpleTreeFrame extends JFrame 

10 { 

11 private static final int DEFAULT_WIDTH = 300; 

12 private static final int DEFAULT_HEIGHT = 200; 


14 public SimpleTreeFrame() 


{ 
16 SetSize(DEFAULT_WIDTH, DEFAULT_HEIGHT) ; 


18 // set up tree model data 

19 

20 Defaul tMutableTreeNode root = new DefaultMutableTreeNode("World") ; 
21 DefaultMutableTreeNode country = new DefaultMutableTreeNode ("USA") ; 
22 root.add(country) ; 

23 DefaultMutableTreeNode state = new DefaultMutableTreeNode("California"); 
24 country. add(state) ; 

25 DefaultMutableTreeNode city = new DefaultMutableTreeNode("San Jose"); 
26 State.add(city); 

27 city = new DefaultMutableTreeNode("Cupertino’) ; 

28 State. add(city); 

29 State = new DefaultMutableTreeNode("Michigan") ; 

30 country.add(state) ; 

31 city = new DefaultMutableTreeNode("Ann Arbor"); 

32 State.add(city) ; 

33 country = new DefaultMutableTreeNode ("Germany") ; 

34 root.add(country) ; 

35 state = new Defaul tMutableTreeNode("Schleswig-Holstein") ; 

36 country.add(state) ; 

37 city = new DefaultMutableTreeNode("Kiel"); 

38 State.add (city); 

39 

40 // construct tree and put it in a scroll pane 

41 

4 JTree tree = new JTree(root); 

43 add(new JScrol]Pane(tree)) ; 

4  } 

45 } 


运行 这 段 程 序 代码 时 ， 最 初 的 树 外 观 如 图 10-19 所 示 。 只 有 根 节 点 和 它 的 子 节点 可 见 。 单 
击 圆圈 图 标 GEF) 展开 子 树 。 当 子 树 折 著 起 来 时 ， 把 手 图 标的 线 伸 出 指向 右边 ， 当 子 树 展开 
时 ， 把 手 图 标的 线 伸 出 指向 下 方 (参见 图 10-20 )。 虽 然 我 们 无 法 得 知 Metal 外 观 的 设计 者 当时 
是 如 何 构 想 的 ， 但 是 我 们 可 以 将 这 个 图 标 看 作 一 个 门 把 手 ， 按 下 把 手 就 可 以 打开 子 树 。 


注意 : 当然 ， 树 的 显示 还 依赖 于 所 选择 的 外 观 模式 。 我 们 这 里 只 讨论 Metal 这 种 外 观 模 
式 。 在 Windows 或 Motif 外 观 模 式 中 ， 把 手 则 具有 我 们 更 熟悉 的 外 观 ， 即 带 有 “一 ”或 
“十 ”的 框 结 构 (参见 图 10-21 )。 
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图 10-19 最初 的 树 的 显示 
可 以 使 用 下 面 这 句 神 奇 的 代码 取消 父子 节点 之 间 的 连接 线 (参见 图 10-22 ): 


tree.putClientProperty("JTree, lineStyle”, "None") ; 
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图 10-21 一 棵 具有 Windows 外 观 的 树 图 10-22 不 带 连 接线 的 树 


相反 地 ， 如 果 要 确保 显示 这 些 线条 ， 则 可 以 使 用 : 

tree.putClientProperty("JTree.lineStyle", "Angled"); 

另 一 种 线条 样式 ,“ 水 平 线 "， 如 图 10-23 所 示 。 这 棵 树 显示 有 水 平 线 ， 而 这 些 水 平 线 只 
是 用 来 将 根 节点 的 孩子 节点 分 离开 来 。 我 们 很 难说 清 这 样 做 的 好 处 。 

默认 情况 下 ， 这 种 树 中 的 根 节点 没有 用 于 折 肢 的 把 手 。 如 果 需 要 的 话 ， 可 以 通过 下 面 的 
调用 来 添加 一 个 把 手 : 

tree. setShowsRootHandles (true) ; 


图 10-24 显示 了 调用 后 的 结果 。 现 在 你 就 可 以 将 整 棵 树 折 和 县 到 根 节 点 中 了 。 
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图 10-23 具有 水 平 线 样式 的 树 图 10-24 具有 一 个 根 把 手 的 树 


相反 地 ， 也 可 以 将 根 节点 完全 隐藏 起 来 。 这 样 做 只 是 为 了 显示 一 个 森林 ， 即 一 个 树 集 ， 
每 棵 树 都 有 它 自己 的 根 节点 。 但 是 仍然 必须 将 森林 中 的 所 有 树 都 放 到 一 个 公共 节点 下 。 因 
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此 ， 可 以 使 用 下 面 这 条 指令 将 根 节点 隐藏 起 来 。 
tree.setRootVisible(false) ; 


请 观察 图 10-25。 它 看 起 来 似乎 有 两 个 根 节点 ， 分别 用 “USA” 和 “Germany” 标 识 了 
出 来 ， 而 实际 上 将 二 者 合并 起 来 的 根 节点 是 不 可 见 的 。 

让 我 们 将 注意 力 从 树 的 根 节 点 转移 到 叶 节 点 。 注 意 ， 这 些 叶 节点 的 图 标 和 其 他 节点 的 图 
标 是 不 同 的 (参见 图 10-26 )。 
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图 10-25 一 个 森林 图 10-26 Hp aaa AY Alte 


在 显示 这 棵 树 的 时 候 ， 每 个 节点 都 绘 有 一 个 图 标 。 实 际 上 一 共有 三 种 图 标 : 叶 节 点 图 标 、 
展开 的 非 叶 市 点 图 标 以 及 闭合 的 非 叶 节点 图 标 。 为 了 简化 起 见 ， 我 们 将 后 面 两 种 图 标 称 为 文 
件 夹 图 标 。 | 

TALE tll ae AL BE ETRE lt. BRUTAL Pi HE 
的 : 如 果 某 个 节点 的 isLeaf 方法 返回 的 是 true， 那 么 就 使 用 叶 节 点 图 标 ， 和 否则 ， 使 用 文件 
夹 图 标 。 

如 果 某 个 节点 没有 任何 儿子 节点 ， 那 么 DefaultMutab1eTreeNode 类 的 isLeaf 方法 
将 返回 true。 因 此 ， 具有 儿子 节点 的 节点 使 用 文件 夹 图 标 ， 没 有 儿子 节点 的 节点 使 用 叶 节 
点 图 标 。 

有 时 ， 这 种 做 法 并 不 合适 。 假 设 我 们 要 向 我 们 那 棵 简单 的 树 中 添加 一 个 “Montana” 节 
点 ， 但 是 我 们 还 不 知道 要 添加 什么 城市 。 此 时 ， 我 们 并 不 希望 一 个 州 节点 使 用 叶 节 点 图 标 ， 
因为 从 概念 上 来 讲 ， 只 有 城市 才 使 用 叶 节 点 。 

JTree 类 无 法 知道 哪些 节点 是 叶 节 点 ， 它 要 询问 树 模 型 。 如 果 一 个 没有 任何 子 节点 的 节 
扩 不 应 该 目 动 地 被 设置 为 概念 上 的 叶 节 点 ， 那 么 可 以 让 树 模 型 对 这 些 叶 节点 使 用 一 个 不 同 的 
标准 ， 即 可 以 查询 其 “允许 有 子 节点 ”的 节点 属性 。 

对 于 那些 不 应 该 有 子 节点 的 节点 ， 调 用 

node. setAl lowsChi ldren(false) ; 

然后 ， 告 诉 树 模型 去 查询 “允许 有 子 节点 ”的 属性 值 以 确定 一 个 节点 是 否 应 该 显示 成 
叶子 图 标 。 你 可 以 使 用 DefaultTreeMode1 类 中 的 方法 setAsksA11owsChildren RER 
动作 : 


model .setAsksAl lowsChildren(true) ; 
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有 了 这 个 判定 规则 ， 人 允许 有 子 节点 的 节点 就 可 以 获得 文件 夹 图 标 ， 而 不 允许 有 子 节点 的 
节点 将 获得 叶子 图 标 。 

另外 ， 如 果 你 是 通过 提供 根 节点 来 构建 一 棵 树 的 ， 那 么 请 在 构造 器 中 直接 提供 “询问 多 
许 有 子 节点 ”属性 值 的 设置 。 


JTree tree = new JTree(root, true); // nodes that don't allow children get leaf icons 





e JTree(TreeModel model) 


根据 一 个 树 模型 构造 一 棵 树 。 


e JTree(TreeNode root) 


e JTree(TreeNode root, boolean asksAllowChildren) 
使 用 默认 的 树 模型 构造 一 棵 树 ， 显 示 根 节点 和 它 的 子 市 扩 。 
RR: root ARTS 
asksAllowChildren 如 果 设 置 为 true， 则 使 用 “人 允许 有 子 节点 ”的 节点 
属性 来 确定 一 个 节点 是 否 是 叶 节 点 
e void setShowsRootHandles(boolean b) 
如 果 b 为 true， 则 根 节点 具有 折 欠 或 展开 它 的 子 节 点 的 把 手 图 标 。 
evoid setRootVisible(boolean b) 
WR b 为 true， 则 显示 根 节点 ， 和 否则 隐藏 根 节点 。 





e boolean isLeaf() 


如 果 该 节点 是 一 个 概念 上 的 叶 节 点 ， 则 返回 true, 
e boolean getAllowsChildren() 


如 果 该 节点 可 以 拥有 子 节 点 ， 则 返回 true. 


cy a NES OE Wh Oy Ae Ys BO NU als ef eee SF VORS ry BRT Wy pike 3 OPG 
i e Tos A SED Se BIE ORE DC T E A ATOR Keister) Tie j ERATI D 
en aaah sA AN ese An a fa VA AE S Pie Naa ESA E pee E a a ey ON A oiea ee 
teat ee EAE Mid e ra soem POS epee vaca A NB Zak Sean ee a a) o a IR SIRE ps : 
ż, Yu M, E AE te A a eS me N ET AEN, EPSP RID NE eee OR VA EAE A CAE Ta 5 
jig Wy Ri EE deme te: Be NO e Ty ROMA EN Ded AEE | Aaa RE Pe Lats Ae j 








e void setUserObject(Object userObject) 
设置 树 节点 用 于 绘制 的 “用 户 对 象 ”。 






e boolean isLeaf(Object node) 
如 果 该 节点 应 该 以 叶 节 点 的 形式 显示 ， 则 返回 true, 


> PS Malt à ? Pa (ye Pipe th ates AS wpe st DIY Sits SG PA Ya i ORT MET TP 本 U SG, A BE eA CTR Wt A TTA T TD EN ve ETB RE KE Sa LANA 

、 ~ , > ‘ : r : : p$ a ENO a ke ae Ps AEA i E RE i We dol ATN pee he KIE AE S FO A YN A E T OE 
Paii * 2 ee A A dr ee i Ce SAPA S EA ESEA ig CAN E bY A TAS ius yee A AR EYN ER oe Ne Tike eras ie 
‘ i TIR hs EG oF TL Me y wpb ee he ke TEI AS ge Bn Men at Cee eta thay Se fs ee 

F Mh y A oe MN te ny OE tie 4 yey i K j 





e void setAsksAllowsChildren(boolean b) 
如 果 b X true, 那么 当 节 点 的 getA11owsChildren 方法 返回 false 时 ， 这 些 节点 
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显示 为 叶 节点。 和 否则， 当 节 点 的 isLeaf 方法 返回 true 时 ， 它 们 显示 为 叶 节点 。 


ee oh ihe as? 4 
rt 










e DefaultMutableTreeNode(Object userObject) 
用 给 定 的 用 户 对 象 构建 一 个 可 变 树 节点 。 

ə void add(MutableTreeNode child) 
将 一 个 节点 添加 为 该 节点 最 后 一 个 子 节点 。 


evoid setAllowsChildren(boolean b) 


WR b 为 true， 则 可 以 向 该 节点 添加 子 节点 。 










SR 和 
en Se, iy! 
Page ree Se se pe 
FM ee 
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eu 


E a EA 
è void putClientProperty(Object key, Object value) 
将 一 个 键 / 值 对 添加 到 一 个 小 表格 中 ， 每 一 个 构件 都 管理 着 这 样 的 一 个 小 表格 。 这 是 
一 种 “紧急 逃生 ”机 制 ， 很 多 Swing 构件 用 它 来 存放 与 外 观 相关 的 属性 。 


10.3.2 ”编辑 树 和 树 的 路 径 


在 下 面 的 一 个 示例 程序 中 ， 将 会 看 到 怎样 编辑 一 棵 树 。 图 10-27 显示 了 用 户 界面 。 如 果 
点 击 “Add Sibling”( 添 加 兄弟 节点 ) Be “Add Child”( 添 加 子 节点 ) 按钮 ， 该 程序 将 向 树 中 
添加 一 个 新 节点 〈 带 有 “New” 标 题 )。 如 果 你 点 击 “Delete”( 删 除 ) 按钮 ， 该 程序 将 删除 当 
前 选中 的 节点 。 

为 了 实现 这 种 行为 ， 需 要 和 弄 清 楚 当 前 选 定 的 是 哪个 节点 。JTree 类 用 的 是 一 种 令 人 惊讶 
的 方式 来 标识 树 中 的 节点 。 它 并 不 处 理 树 的 节点 ， 而 是 处 理 对 象 路 径 ( 称 为 树 路 径 )。 一 个 树 
路 径 从 根 节点 开始 ， 由 一 个 子 节点 序列 构成 ， 参 见 图 10-28。 


类 TreeEditTest 中 ,SimpleTree 


Ga Word 


: alifornia 
| ichigan 
= n Arbor 


he fal Germany 





图 10-27 编辑 一 棵 图 10-28 一 个 树 路 径 


你 可 能 要 怀疑 JTree 类 为 什么 需要 整个 路 径 。 它 不 能 只 获得 一 个 TreeNode， 然 后 不 断 
调用 getParent 方法 吗 ? 实际 上 ，JTree 类 一 点 都 不 清楚 TreeNode 接口 的 情况 。 该 接口 
从 来 没有 被 TreeModel 接口 用 到 过 ， 它 只 被 Defau1tTreeModel 的 实现 用 到 了 。 你 完全 
可 以 拥有 其 他 的 树 模 型 ， 这 些 树 模 型 中 的 节点 可 能 根本 就 没有 实现 TreeNode 接口 。 如 果 你 
使 用 的 是 一 个 管理 其 他 类 型 对 象 的 树 模 型 ， 那 么 这 些 对 象 有 可 能 根本 就 没有 getParent 和 
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getCchi1d 方 法 。 它 们 彼此 之 间 当 然 会 有 其 他 某 种 连接 。 将 其 他 节点 连接 起 来 这 是 树 模型 的 
职责 ，JTree 类 本 身 并 没有 节点 之 间 连 接 属性 的 任何 线索 。 因 此 ，JTree 类 总 是 需要 用 完整 
的 路 径 来 工作 。 

TreePath 类 管理 着 一 个 0bject (不 是 TreeNode ! ) 引用 序列 。 有 很 多 JTree 的 方法 
都 可 以 返回 TreePath 对 象 。 当 拥有 一 个 树 路 径 时 ， 通 常 只 需要 知道 其 终端 节点 ， 该 节 后 可 
以 通过 getLastPathComponent 方法 得 到 。 例 如 ， 如 果 要 查找 一 棵 树 中 当前 选 定 的 市 反 ， 
可 以 使 用 JTree 类 中 的 getSelectionPath 方法 。 它 将 返回 一 个 TreePath 对 象 ， 根据 这 
个 对 象 就 可 以 检索 实际 节点 。 


TreePath selectionPath = tree.getSelectionPath() ; 
Defaul tMutableTreeNode selectedNode 
= (DefaultMutableTreeNode) selectionPath.getLastPathComponent () ; 


实际 上 ， 由 于 这 种 特定 查询 经 常 被 使 用 到 ， 因 此 还 提供 了 一 个 更 方便 的 方法 ， 它 能 够 立 
即 给 出 选 定 的 节 氮 。 


DefaultMutableTreeNode selectedNode 
= (DefaultMutableTreeNode) tree.getLastSelectedPathComponent () ; 


该 方法 之 所 以 没有 被 称 为 getSelectedNode， 是 因为 这 棵 树 并 不 了 解 它 包 含 的 节点 ， 
它 的 树 模型 只 处 理 对 象 的 路 径 。 
注意 : 树 路 径 是 JTree 类 描述 节点 的 两 种 方式 之 一 。JTree 有 许多 方法 可 以 接收 或 返回 

一 个 整数 索引 一 一 行 的 位 置 。 行 的 位 置 仅仅 是 节点 在 树 中 显示 的 一 个 行 号 (从 0 开始 )。 

只 有 那些 可 视 节 点 才 有 行 号 ， 并 且 如 果 一 个 节点 之 前 的 其 他 节点 展开 、 折 司 或 者 被 修改 

过 ， 这 个 节点 的 行 号 也 会 随 之 改变 。 因 此 ， 你 应 该 避免 使 用 行 的 位 置 。 相 反 地 ， 所 有 使 

用 行 的 JTree 方法 都 有 一 个 与 之 等 价 的 使 用 树 路 径 的 方法 。 

一 旦 你 选 定 了 的 某 个 节点 ， 那 么 就 可 以 对 它 进 行 编辑 了 。 不 过 ， 不 能 直接 向 树 节点 添加 
FHA: 

selectedNode.add(newNode); // No! 

如 果 你 改变 了 节点 的 结构 ， 那 么 改变 的 只 是 树 模型 ， 而 相关 的 视图 却 没有 被 通知 到 。 可 
以 自己 发 送 一 个 通知 消息 ， 但 是 如 果 使 用 DefaultTreeModel 类 的 insertNodeInto 方法 ， 
那么 该 模型 类 会 全 权 负 责 这 件 事情 。 例 如 ， 下 面 的 调用 可 以 将 一 个 新 节点 作为 选 定 节 点 的 最 
后 子 节点 添加 到 树 中 ， 并 通知 树 的 视图 。 


model .insertNodeInto(newNode, selectedNode, selectedNode.getChildCount ()) ; 

类 似 的 调用 removeNodeFromParent 可 以 移 除 一 个 节点 并 通知 树 的 视图 : 
model . removeNodeFromparent (selectedNode) ; 

如 果 想 保持 节点 结构 ， 但 是 要 改变 用 户 对 象 ， 那 么 可 以 调用 下 面 这 个 方法 : 
model ,nodeChanged(changedNode) ; 
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目 动 通知 是 使 用 DefaultTreeModel 的 主要 优势 。 如 果 你 提供 自己 的 树 模型 ， 那 么 必 
须 目 己 动手 实现 这 种 自动 通知 。( 详 见 Kim Topley 撰写 的 《 Core Swing 》。) 


qb 警告 : DefaultTreeModel A—* reload 方法 能 够 将 整个 模型 重新 载 入 。 但 是 ， 不 要 
在 进行 了 少数 几 个 修改 之 后 ， 只 是 为 了 更 新 树 而 调用 reload 方法 。 在 重建 一 棵 树 的 时 
候 ， 根 节点 的 子 节点 之 后 的 所 有 节点 将 全 部 再 次 折 登 起 来 。 如 果 你 的 用 户 在 每 次 修改 之 
后 都 要 不 断 地 展开 整 棵 树 ， 这 确实 是 一 件 令 人 烦心 的 事 。 


当 视 图 接收 到 节点 结构 被 改变 的 通知 时 ， 它 会 更 新 显示 树 的 视图 ， 但 是 不 会 自动 展开 某 
个 节操 以 展现 新 添加 的 子 节 点 。 特 别 是 在 我 们 上 面 那 个 示例 程序 中 ， 如 果 用 户 将 一 个 新 节点 
添加 到 其 子 节点 正 处 于 折 又 状态 的 节点 上 ， 那 么 这 个 新 添加 的 节点 就 被 悄 无 声息 地 添加 到 了 
一 个 处 于 折 秋 状态 的 子 树 中 ， 这 就 没有 给 用 户 提供 任何 反馈 信息 以 告诉 用 户 已 经 执行 了 该 命 
令 。 在 这 种 情况 下 ， 你 可 能 需要 特别 费劲 地 展开 所 有 的 父 节点 ， 以 便 让 新 添加 的 节点 成 为 可 
A 可 以 使 用 类 JTree 中 的 方法 makeVisible 实现 这 个 目的 。makeVisible 方法 将 接 

一 个 树 路 径 作为 参数 ， 该 树 路 径 指向 应 该 变 为 可 视 的 节点 。 

Bb, BRER ALA ALANINE. A THROES. 
首先 要 调用 DefaultTreeModel 类 中 的 getPathToRoot 方法 ， 它 返 回 一 个 包含 了 某 一 节点 
到 根 市 点 之 间 所 有 节点 的 数组 TreeNode[]。 可 以 将 这 个 数组 传递 给 一 个 TreePath 构造 器 。 

例如 ， 下 面 展示 了 怎样 将 一 个 新 节点 变 成 可 见 的 : 


TreeNode[] nodes = model .getPathToRoot (newNode) : 
TreePath path = new TreePath(nodes) ; 
tree.makeVisible(path) ; 


注意 : SARAH, DefaultTreeModel 类 好 像 完 全 忽视 了 TreePath KR, RECH 
职责 是 与 一 个 JTree i& (2, JTree 类 大 量 地 使 用 到 了 树 路 径 ， 而 它 从 不 使 用 节点 对 象 
数组 。 


但 是 ， 现 在 假设 你 的 树 是 放 在 一 个 滚动 面板 里 面 ， 在 展开 树 节 点 之 后 ， 新 节点 仍 是 不 可 
见 的 ， 因 为 它 落 在 视图 之 外 。 为 了 克服 这 个 问题 ， 请 调用 

tree.scrol]PathToVisible(path) ; 
而 不 是 调用 makeVisib1e。 这 个 调用 将 展开 路 径 中 的 所 有 节点 ， 并 告诉 外 围 的 滚动 面板 将 
路 径 末 端的 节点 滚动 到 视图 中 (参见 图 10-29 )。 

默认 情况 下 ， 这 些 树 节 点 是 不 可 编辑 的 。 不 过 ， 如 果 调 用 

tree,SetEditable(true) ; 

那么 ， 用 户 就 可 以 编辑 某 一 节点 了 。 可 以 先 双击 该 节点 ， 然 后 编辑 字符 串 ， 最 后 按 
下 回 车 键 。 双 击 操作 会 调用 默认 单元 格 编辑 器 ， 它 实现 了 Defau1tCce11Editor 类 ( 参 
见 图 10-30 )。 也 可 以 安装 其 他 一 些 单元 格 编辑 器 ， 其 过 程 与 表格 单元 格 编辑 器 中 讨论 的 过 程 
一 样 。 





滚动 到 视图 
a 





图 10-29 滚动 以 显示 新 节点 的 滚动 面板 


程序 清单 10-13 展示 了 树 编辑 程序 的 完整 源 代 码 。 运 行 该 程序 ， 添 加 几 个 新 三 点 ， 然 后 
通过 双击 它们 进行 编辑 操作 。 SAAS EEEN TO, 以 及 滚 
动 面板 是 怎样 让 添加 的 节点 保持 在 视图 中 的 。 
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图 10-30 ”默认 的 单元 格 编辑 需 





AD GD Nu en wo A u N RE 


10 


package treeEdit; 


import java.awt.*; 


import javax.swing.*; 
import javax.swing.tree.*; 


/** 


* A frame with a tree and buttons to edit the tree. 
$ 


public class TreeEditFrame extends JFrame 


{ 
private static final int DEFAULT_WIDTH = 400; 
private static final int DEFAULT_HEIGHT = 200; 


private DefaultTreeModel model ; 
private JTree tree; 


public TreeEditFrame() 
setSize(DEFAULT_WIDTH, DEFAULT_HEIGHT) ; 
// construct tree 
TreeNode root = makeSampleTree() ; 
model = new DefaultTreeModel (root) ; 
tree = new JTree(model) ; 
tree. setEditable(true) ; 


// add scroll pane with tree 


JScrollPane scrol]Pane = new JScrol]Pane(tree) ; 
add(scrol]Pane, BorderLayout.CENTER); - 


makeButtons() ; 
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public TreeNode makeSamp]eTree() 


DefaultMutableTreeNode root = new DefaultMutableTreeNode("World") ; 
DefaultMutableTreeNode country = new DefaultMutableTreeNode ("USA") ; 
root.add(country) ; 

DefaultMutableTreeNode state = new DefaultMutableTreeNode("Cali fornia"); 
country.add (state) ; 

DefaultMutableTreeNode city = new DefaultMutableTreeNode("San Jose"); 
State. add(city); 

city = new DefaultMutableTreeNode("San Diego"); 

State. add (city); 

State = new DefaultMutableTreeNode("Michigan"); 

country.add (state) ; 

city = new DefaultMutableTreeNode("Ann Arbor"); 

State.add(city); 

country = new DefaultMutableTreeNode("Germany"); 

root.add(country) ; 

State = new DefaultMutableTreeNode("Schleswig-Holstein"); 
country.add(state) ; 

city = new DefaultMutableTreeNode("Kiel"); 

State.add(city); 

return root; 


* Makes the buttons to add a sibling, add a child, and delete a node. 


public void makeButtons () 


JPanel panel = new JPanel (); 
JButton addSiblingButton = new JButton("Add Sibling"); 
addSiblingButton.addActionListener(event -> 


DefaultMutableTreeNode selectedNode = (DefaultMutableTreeNode) tree 
.getLastSelectedPathComponent () ; 


if (selectedNode == null) return; 

DefaultMutableTreeNode parent = (DefaultMutableTreeNode) selectedNode.getParent(); 
if (parent == null) return; 

DefaultMutableTreeNode newNode = new Defaul tMutableTreeNode ("New") ; 


int selectedIndex = parent.getIndex(selectedNode) ; 
model .insertNodeInto(newNode, parent, selectedIndex + 1); 


// now display new node 


TreeNode[] nodes = model .getPathToRoot (newNode) ; 
TreePath path = new TreePath(nodes) ; 
tree.scrol]PathToVisible(path) ; 

}); 
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91 panel .add(addSiblingButton) ; 

92 

93 JButton addChildButton = new JButton("Add Child"); 

94 addChi ]dButton. addActionListener(event -> 

95 { 

96 DefaultMutableTreeNode selectedNode = (DefaultMutableTreeNode) tree 
97 .getLastSel ectedPathComponent () ; 

98 

99 if (selectedNode == null) return; 

100 

101 DefaultMutableTreeNode newNode = new DefaultMutableTreeNode ("New") ; 
102 model .insertNodeInto(newNode, selectedNode, selectedNode.getChildCount()) ; 
103 

104 // now display new node 

105 

106 TreeNode[] nodes = mode] .getPathToRoot (newNode) ; 

107 TreePath path = new TreePath(nodes) ; 

108 tree.scrol]PathToVisible(path) ; 


109 Di 
110 panel .add(addChildButton) ; 


112 JButton deleteButton = new JButton("Delete"); 

113 deleteButton.addActionListener(event -> 

114 

115 DefaultMutableTreeNode selectedNode = (DefaultMutableTreeNode) tree 
116 „getLastSelectedPathComponent () ; 

117 

118 if (selectedNode != null && selectedNode.getParent() != null) model 
119 .removeNodeFromParent (sel ectedNode) ; 

120 Hi 

121 panel .add(deleteButton) ; 


122 add(panel, BorderLayout. SOUTH) ; 





e TreePath getSelectionPath( ) 
获取 到 当前 选 定 节点 的 路 径 ， 如 果 选 定 多 个 节点 ， 则 获取 到 第 一 个 选 定 节点 的 路 径 。 
如 果 没 有 选 定 任何 节点 ， 则 返回 nu11。 

e Object getLastSelectedPathComponent( ) 
获取 表示 当前 选 定 节点 的 节点 对 象 ， 如 果 选 定 多 个 节点 ， 则 获取 第 一 个 选 定 的 节点 。 
如 果 没 有 选 定 任何 节点 ， 则 返回 nu11。 

evoid makeVisible(TreePath path) 
展开 该 路 径 中 的 所 有 节点 。 

e void scrollPathToVisible(TreePath path) 
展开 该 路 径 中 的 所 有 节点 ， 如 果 这 棵 树 是 置 于 滚动 面板 中 的 ， 则 滚动 以 确保 该 路 径 中 
的 最 后 一 个 节点 是 可 见 的 。 
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e Object getLastPathComponent( ) 
获取 该 路 径 中 最 后 一 个 节点 ， 也 就 该 路 径 代 表 的 节点 对 象 。 








è TreeNode getParent() 
返回 该 节点 的 父 节 点 。 

e TreeNode getChildAt(int index) 
查找 给 定 索引 号 上 的 子 节 点 。 该 索引 号 必须 在 0 和 getChildCount()-1 之 间 。 

® int getChildCount() 
返回 该 节点 的 子 节点 个 数 。 


e Enumeration children() 


BEARER, AT EE ARB AP A. 





evoid insertNodeInto(MutableTreeNode newChild, MutableTreeNode 
parent, int index) 
将 newChild 作为 parent 的 新 子 节点 添加 到 给 定 的 索引 位 置 上 ， 并 通知 树 模型 的 监 
ITAY o 

e void removeNodeFromParent(MutableTreeNode node) 
将 节点 node 从 该 模型 中 删除 ， 并 通知 树 模型 的 监听 器 。 

e void nodeChanged(TreeNode node) 
通知 树 模 型 的 监听 器 : 节点 node 发 生 了 改变 。 

èe void nodesChanged(TreeNode parent, int[] changedChildIndexes) 
通知 树 模型 的 监听 器 : 节点 parent 所 有 在 给 定 索引 位 置 上 的 子 节点 发 生 了 改变 。 

e void reload() 
将 所 有 节点 重新 载 人 到 树 模 型 中 。 这 是 一 项 动作 剧烈 的 操作 ， 只 有 当 由 于 一 些 外 部 作 
用 ， 导 致 树 的 节点 完全 改变 时 ， 才 应 该 使 用 该 方法 。 


10.3.3 ”节点 枚 举 


有 时 为 了 查找 树 中 一 个 节点 ， 必 须 从 根 节点 开始 ， 遍 历 所 有 子 节 点 直到 找到 相 匹 配 的 节 
fio DefaultMutableTreeNode 类 有 几 个 很 方便 的 方法 用 于 迭代 遍历 所 有 节点 。 

breadthFirstEnumeration 方法 和 depthFirst Enumeration 方法 分 别 使 用 广度 优 
先 或 深度 优先 的 遍历 方式 ， 返 回 枚 举 对 象 ， 它 们 的 nextETement 方法 能 够 访问 当前 节点 的 
所 有 子 节 点 。 图 10-31 显示 了 对 示例 树 进行 遍历 的 情况 ， 节 点 标签 则 指示 遍历 节点 时 的 先后 
次 序 。 
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图 10-31 树 的 遍历 顺序 


按照 广度 优先 的 方式 进行 枚 举 是 最 容易 可 视 化 的 。 树 是 以 层 的 形式 遍历 的 ， 首 先 访问 根 
节点 ， 然 后 是 它 的 所 有 子 节点 ， 接 着 是 它 的 孙子 节点 ， 依 此 类 推 。 

为 了 可 视 化 深度 优先 的 枚 举 ， 让 我 们 想象 一 只 老鼠 陷入 一 个 树 状 陷阱 的 情形 。 它 沿 着 第 一 
条 路 径 迅 速 息 行 ， 直 到 到 达 一 个 叶 节 点 位 置 。 然 后 ， 原 路 返回 并 转 入 下 一 条 路 径 ， 依 此 类 推 。 

计算 机 科学 家 也 将 其 称 为 后 序 遍 历 ( postorder traversal)， 因 为 整个 查找 过 程 是 先 访 问 到 
子 节点 ， 然 后 才 访 问 到 父 节 点 。postorderTraversal 方法 是 depthFirstTraversal 的 
同 义 语 。 为 了 完整 性 ， 还 存在 一 个 preorderTraversal 方法 ， 它 也 是 一 种 深度 优先 搜索 方 
法 ,但 是 它 首 先 枚 举 父 节 点 ， 然 后 是 子 节 所 。 

下 面 是 一 种 典型 的 使 用 模式 : 


Enumeration breadthFirst = node,breadthFirstEnumeration() ; 
while (breadthFirst,hasMoreElements()) 
do something with breadthFirst.nextE]ement () ; 


最 后 ， 还 有 一 个 相关 方法 pathFromAncestorEnumeration， 用 于 查找 一 条 从 祖先 节 
点 到 给 定 节点 之 间 的 路 径 ， 然 后 枚 举 出 该 路 径 中 的 所 有 节点 。 整 个 过 程 并 不 需要 大 量 的 处 理 
操作 ， 只 需要 不 断 调用 getParent HIRR, 然后 将 该 路 径 倒置 过 来 存放 即 可 。 

在 我 们 的 下 个 示例 程序 中 ， 将 运用 到 节点 枚 举 。 该 程序 显示 了 类 之 间 的 继承 树 。 向 窗 体 
最 下 面 的 文本 框 中 输入 一 个 类 名 ， 该 类 以 及 它 的 所 有 父 类 就 会 添加 到 树 中 (参见 图 10-32 )。 


ə class java lang.Object 
¢- @ class java. awt.Component 
¢- @ class java.awt.Container 
9? @ class java. awt. Window 
¢- @ class java.awt.Frame 
? @ class javax.swing. JFrame 


| — @ class ClassTreeFrame 
? @ class java.util. AbstractCollection 
9- a3 class java. util. AbstractList 





~ @ class java util. ArrayList 
b 9 class java. util. Calendar 
~ @ class java.util. GregorianCalendar 





图 | 10-32 一 棵 继承 树 
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在 这 个 示例 中 ， 我 们 充分 利用 了 这 个 事实 ， 即 树 节 点 的 用 户 对 象 可 以 是 任何 类 型 的 对 
象 。 因 为 我 们 这 里 的 节点 是 用 来 描述 类 的 ， 因 此 我 们 在 这 些 节点 中 存储 的 是 Class WR. 
当然 ， 我 们 不 想 对 同一 个 类 对 象 添 加 两 次 ， 因 此 我 们 必须 检查 一 个 类 是 否 已 经 存在 于 树 
中 。 如 果 在 树 中 存在 给 定 用 户 对 象 的 节点 ， 那 么 下 面 这 个 方法 就 可 以 用 来 查找 该 节点 。 
public DefaultMutableTreeNode findUserObject (Object obj) 
{ 
Enumeration e = root.breadthFirstEnumeration(); 
while (e.hasMoreEl ements ()) 
{ 
DefaultMutableTreeNode node = (DefaultMutableTreeNode) e.nextElement(); 


if (node. getUserObject () .equals(obj)) 
return node; 
} 


return null; 


10.3.4 ”绘制 节点 


在 应 用 中 可 能 会 经 党 需要 改变 树 构件 绘制 节点 的 方式 ， 最 常见 的 改变 当然 是 为 节 
点 和 叶 贡 点 选取 不 同 的 图 标 ， 其 他 一 些 改变 可 能 涉及 节点 标签 的 字体 或 节点 上 的 图 
像 绘 制 等 方面 。 所 有 这 些 改变 都 可 以 通过 向 树 中 安装 一 个 新 的 树 单元 格 绘制 器 来 实 
现 。 在 默认 情况 下 ，JTree 类 使 用 DefaultTreeCellRenderer 对 象 来 绘制 每 个 节点 。 
DefaultTreeCel1lRenderer 类 继承 自 JLabel 类 ， 该 标签 包含 节点 图 标 和 节点 标签 。 


注意 : 单元 格 绘制 器 并 不 能 绘制 用 于 展开 或 折 登 子 树 的 “把 手 ” 图 标 。 这 些 把 手 是 外 观 
模式 的 一 部 分 ， 建 议 最 好 不 要 试图 改变 它们 。 


可 以 通过 以 下 三 种 方式 定制 显示 外 观 : 

e 可 以 使 用 Defau1ltTreeCce11Renderer 改变 图 标 、 字 体 以 及 背景 颜色 。 这 些 设置 适用 
于 树 中 所 有 节点 。 

o 可 以 安装 一 个 继承 了 Defau1tTreeCe11Renderer 类 的 绘制 器 ， 用 于 改变 每 个 节点 的 
图 标 、 字 体 以 及 背景 颜色 。 

e 可 以 安 半 一 个 实现 了 TreeCellRenderer 接口 的 绘制 器 ， 为 每 个 节点 绘制 自 定 义 的 
图 像 。 

让 我 们 逐个 人 研究 这 几 种 可 能 。 最 简单 的 定制 方法 是 构建 一 个 DefaultTreeCellRenderer 

对 象 ， 改 变 图 标 ， 然 后 将 它 安装 到 树 中 : 


DefaultTreeCellRenderer renderer = new DefaultTreeCellRenderer(); 

renderer, setLeafIlcon(new ImageIcon("blue-ball.gif")); // used for leaf nodes 
renderer. setClosedIcon(new ImageIcon("red-ball.gif")); // used for collapsed nodes 
renderer.setOpenIcon(new ImageIcon("yellow-ball.gif")); // used for expanded nodes 
tree. setCel]Renderer(renderer) ; 


可 以 在 图 10-32 中 看 到 运行 效果 。 我 们 只 是 使 用 “ 球 ” 图 标 作为 占 位 符 ， 这 里 假设 你 的 
用 户 界面 设计 者 会 为 你 的 应 用 提供 合适 的 图 标 。 
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我 们 不 建议 改变 整 棵 树 中 的 字体 或 背景 颜色 ， 因 为 这 实际 上 是 外 观 设置 的 职责 所 在 。 

不 过 ， 改 变 树 中 个 别 节点 的 字体 ， 以 突显 某 些 节 点 还 是 很 有 用 的 。 如 果 仔 细 观 察 图 10-32, 
你 会 看 到 抽象 类 是 设 成 斜体 字 的 。 

为 了 改变 单个 节点 的 外 观 ， 需 要 安装 一 个 树 单元 格 绘制 器 。 树 单元 格 绘制 器 与 我 们 在 本 
章 前 一 节 讨 论 的 列表 单元 格 绘制 器 很 相似 。 TreeCe11Renderer 接口 只 有 下 面 这 个 单一 方法 : 


Component getTreeCellRendererComponent(JTree tree, Object value, boolean selected, 
boolean expanded, boolean leaf, int row, boolean hasFocus) 


DefaultTreeCel1Renderer 4 ff) getTreeCel1RendererComponent 方法 返回 的 是 
this， 换 名 话说， 就 是 一 个 标签 (DefaultTreeCe11Renderer 类 继承 了 JLabel 2), WRB 
定制 一 个 构件 ， 需 要 继承 DefaultTreeCe11Renderer 类 。 按 照 以 下 方式 覆盖 getTreeCell 
RendererComponent 方法 : 调用 超 类 中 的 方法 ， 以 便 准备 标签 的 数据 ， 然 后 定制 标签 属性 ， 
最 后 返回 this. 


class MyTreeCellRenderer extends DefaultTreeCellRenderer 


public Component getTreeCel]RendererComponent (JTree tree, Object value, boolean selected, 
boolean expanded, boolean leaf, int row, boolean hasFocus) 
{ 


Component comp = super.getTreeCellRendererComponent(tree, value, selected, 
expanded, leaf, row, hasFocus); 
DefaultMutableTreeNode node = (DefaultMutableTreeNode) value; 
look at node.getUserObject(); 
Font font = appropriate font; 
comp. setFont (font) ; 
return comp; 
} 
}; 


Q 警告 : getTreeCe11RendererComponent 方法 的 value 参数 是 节点 对 象 ， 而 不 是 用 户 
对 象 ! 请 记 住 ， 用 户 对 象 是 Defau1tMutab1eTreeNode 的 一 个 特性 ， 而 JTree 可 以 包 
念 任意 类 型 的 节点 。 如 果树 使 用 的 是 DefaultMutab1leTreeNode 节点 ， 那 么 必须 在 第 
二 个 步骤 中 获取 这 个 用 户 对 象 ， 正 如 我 们 在 上 一 个 代码 示例 中 所 做 的 那样 。 


Q 警告 : DefaultTreeCe11Renderer 为 所 有 节点 使 用 的 是 相同 的 标签 对 象 ， 仅 仅 是 为 每 
个 节点 改变 标签 文本 而 已 。 如 果 想 为 某 个 特定 节点 更 改 字 体 ， 那 么 必须 在 该 方法 再 次 调 
用 的 时 候 将 它 设 置 回 默 认 值 。 否 则 ， 随 后 的 所 有 节点 都 会 以 更 改过 的 字体 进行 绘制 ! 见 
程序 清单 10-14 中 的 程序 代码 ， 看 看 它 是 怎样 将 字体 恢复 到 其 默认 值 的 。 


我 们 没有 给 出 有 关 用 来 绘制 任意 图 形 的 树 单 元 格 绘制 器 的 示例 。 如 果 你 需要 这 个 功能 ， 
可 以 参考 程序 清单 10-4 中 的 列表 单元 格 绘制 器 ; 它们 用 到 的 技术 完全 相似 。 

根据 Class 对 象 有 无 ABSTRACT 修饰 符 ， 程 序 清单 10-14 中 的 C1assNameTreeCe11Renderer 
会 将 类 名 设置 为 标准 字体 或 斜体 字体 。 我 们 不 想 设置 成 特殊 的 字体 ， 因 为 我 们 不 想 改变 任何 
通常 用 于 显示 标签 的 字体 外 观 。 因 此 ， 我 们 使 用 来 自 于 标签 本 身 的 字体 以 及 从 它 衍生 而 来 的 
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一 个 斜体 字体 。 请 回忆 一 下 ， 全 部 的 调用 只 返回 一 个 共享 的 单一 的 JLabel 对 象 。 因 此 ， 我 
们 需要 保存 初始 字体 ， 并 在 下 一 次 调用 gettreeCel1RendererComponent 方法 时 将 其 恢复 
为 初始 值 。 

同时 ， 注 意 一 下 我 们 是 如 何 改变 C1assTreeFrame 构造 器 中 的 节点 图 标的 。 
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e Enumeration breadthFirstEnumeration() 


e Enumeration depthFirstEnumeration() 

e Enumeration preOrderEnumeration() 

è Enumeration postOrderEnumeration( ) 
返回 枚 举 对 象 ， 用 于 按照 某 种 特定 顺序 访问 树 模型 中 所 有 节点 的 。 在 广度 优先 遍历 中 ， 
先 访问 离 根 节 点 更 近 的 子 节 点 ， 再 访问 那些 离 根 节点 远 的 节点 。 在 深度 优先 遍历 中 ， 
先 访问 一 个 节点 的 所 有 子 节点 ， 然 后 再 访问 它 的 兄弟 节点 。postorderEnumeration 
方法 与 depthFirstEnumeration 基本 上 相似 。 除 了 先 访问 父 节 点 ， 后 访问 子 节点 之 

后 序 遍 历 基 本 上 一 样 。 
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e Component getTreeCellRendererComponent(JTree tree, Object value, 


boolean selected, boolean expanded, boolean leaf, int row, boolean 


hasFocus ) 
返回 一 个 paint 方法 被 调用 的 构件 ， 以 便 绘制 树 的 一 个 单元 格 。 
参数 : tree 包含 要 绘制 节点 的 树 
value 要 绘制 的 节点 
selected 如 果 该 节点 是 当前 选 定 的 节点 ， 则 为 true 
expanded 如 果 该 节点 的 子 节点 可 见 ， 则 为 true 
leaf 如 果 该 节点 应 该 显示 为 叶 节 点 ， 则 为 true 
row 显示 包含 该 节点 的 那 行 


hasFocus 如 果 当 前 选 定 的 节点 拥有 输入 焦点 ， 则 为 true 
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e void setLeafIcon(Icon icon) 


e void setOpenIcon(Icon icon) 
e void setClosedIcon(Icon icon) 
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10.3.5 监听 树 事件 
通常 情况 下 ， 一 个 树 构件 会 成 对 地 伴随 着 其 他 某 个 构件 。 当 用 户 选 定 了 一 些 树 节点 时 ， 
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某 些 信息 就 会 在 其 他 窗口 中 显示 出 来 。 参 见 图 10-33 的 示例 。 当 用 户 选 定 一 个 类 时 ， 这 个 类 
的 实例 及 静态 变量 信息 就 会 在 右边 的 文本 区 显示 出 来 。 


@ class java.lang. Object 
@ class java. awt. Component 
$- @ class java.awt Container 
? @ class java. awt. Window 
? @ class java.awt.Frame 
$-a 


L- @ ciass CiassTreeFrame 应 
@ class java.util AbstractColiection 
¢- @ class java.util AbstractList 
L @ class java util. ArrayList 





图 10-33 一 个 类 浏览 器 
为 了 获得 这 项 功能 ， 你 可 以 安装 一 个 树 选 择 监 听 器 。 该 监听 需 必 须 实 现 TreeSelection- 


Listener 接口 ， 这 是 一 个 只 有 下 面 这 个 单一 方法 的 接口 : 


void valueChanged(TreeSelectionEvent event) 

每 当 用 户 选 定 或 者 撤销 选 定 树 节 点 的 时 候 ， 这 个 方法 就 会 被 调用 。 
可 以 按照 下 面 这 种 通常 方式 向 树 中 添加 监听 楷 : 
tree.addTreeSelectionListener(listener) ; 


可 以 设 定 是 否 允 许 用 户 选 定 一 个 单一 的 节点 、 连 续 区 间 内 的 节点 或 者 一 个 任意 的 、 可 能 


不 连续 的 节点 集 。JTree 类 使 用 TreeSelectionModel 来 管理 节点 的 选择 。 必 须 检索 整个 
模型 ， 以 便 将 选择 状态 设置 为 SINGLE_TREE_SELECTION、CONTIGUOUS_TREE_SELECTION 
或 DISCONTIGUOUS_TREE_SELECTION 三 种 状态 之 一 。( 在 默认 情况 下 是 非 连续 的 选择 模式 。) 
例如 ， 在 我 们 的 类 浏览 器 中 ， 我 们 希望 只 允许 选择 单个 类 : 


int mode = TreeSelectionModel .SINGLE_TREE_SELECTION; 
tree. getSelectionModel ().setSelectionMode (mode) ; 


除了 设置 选择 模式 之 外 ， 你 并 不 需要 担心 树 的 选择 模型 。 

注意 : 用 户 怎样 选 定 多 个 选项 则 依赖 于 外 观 。 在 Metal 外 观 中 ， 按 下 CTRL 键 ， 同 时 点 
击 一 个 选项 将 它 添加 到 选项 集中 ， 如 果 当 前 已 经 选 定 了 该 选项 ， 则 将 其 从 选项 集中 删除 。 
按 下 SHIFT 键 ， 同 时 点 击 一 个 选项 ， 可 以 选 定 一 个 选项 范围 ， 它 从 先前 已 选 定 的 选项 延 
伸 到 新 选 定 的 选项 。 

要 找 出 当前 的 选项 集 ， 可 以 用 getSelectionPaths 方法 来 查询 树 : 

Treepath[] selectedPaths = tree.getSelectionPaths() ; 


如 果 想 限制 用 户 只 能 做 单项 选择 ， 那 么 可 以 使 用 便捷 的 getSelectionPath 方法 ， 它 
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将 返回 第 一 个 被 选择 的 路 径 ， 或 者 是 nu11 (如 果 没 有 任何 路 径 被 选 )。 


@ 警告 : TreeSelectionEvent 类 具有 一 个 getPaths 方法 ， 它 将 返回 一 个 TreePath 对 
象 数组 ， 但 是 该 数组 描述 的 是 选项 集 的 变化 ， 而 不 是 当前 的 选项 集 。 


程序 清单 10-14 显示 了 类 树 这 个 程序 的 窗 体 类 。 该 程序 可 以 显示 继承 的 层次 结构 ， 并 且 
将 抽象 类 定制 显示 为 斜体 字 (参见 程序 清单 10-15 的 单元 格 绘制 器 )。 可 以 在 窗 体 底部 的 文本 
框 中 输入 任何 类 名 ， 按 下 Enter 键 或 者 点 击 “Add” 按 钮 ， 将 该 类 及 其 超 类 添加 到 树 中 。 必 
须 输入 完整 的 包 名 ， 例 如 java.uti1.ArrayList。 

这 个 程序 用 到 了 一 点 小 小 的 技巧 ， 它 是 通过 反射 机 制 来 构建 这 棵 类 树 的 。 这 项 操作 包含 
É addClass 方法 内 。( 细 节 倒 不 那么 重要 ， 在 这 个 例子 中 ， 我 们 之 所 以 使 用 类 树 ， 是 因为 继 
承 树 不 需要 怎么 费劲 地 编码 就 能 生成 一 棵 丰满 的 树 。 如 果 想 在 自己 的 应 用 中 显示 树 ， 那 么 你 
需要 准备 自己 的 层次 结构 数据 的 来 源 。) 该 方法 使 用 广度 优先 的 搜索 算法 ， 通 过 调用 我 们 在 前 
— SHA findUser0bject 方法 ,来 确定 当前 的 类 是 否 已 经 存在 于 树 中 。 如 果 这 个 类 还 不 
存在 于 树 中 ， 那 么 我 们 将 其 超 类 添加 到 这 棵 树 中 ， 然 后 将 新 节点 作为 它 的 子 节点 ， 并 使 该 节 
点 成 为 可 见 的 。 

在 选择 树 的 一 个 节点 时 ， 右 侧 的 文本 域 将 填充 为 选中 的 类 的 属性 。 在 窗 体 构造 器 中 ， 限 
制 用 户 只 能 进行 单个 选项 的 选择 ， 并 添加 了 一 个 树 选 择 监 听 器 。 当 调用 valueChanged 方法 
时 ,我 们 忽略 它 的 事件 参数 ， 只 向 该 树 询问 当前 的 选 定 路 径 。 正 如 通常 情况 那样 ， 我 们 必须 
获得 路 径 中 的 最 后 一 个 节点 ， 并 且 查 看 它 的 用 户 对 象 。 然 后 调用 getFieldDescription 方 
法 ， 该 方法 使 用 反射 机 制 将 所 选 类 的 所 有 属性 组 装 成 一 个 字符 串 。 





package treeRender; 


import java.awt.*; 

import java.awt.event.*; 
import java.lang.reflect.*; 
import java.util.*; 


co ~ an wn p> tws ma — i 


import javax.swing.*; 
import javax.swing.tree.*; 


wo 


u /** 

12 * This frame displays the class tree, a text field, and an "Add" button to add more classes 
13 * into the tree. 

14 */ 

15 public class ClassTreeFrame extends JFrame 


17 private static final int DEFAULT_WIDTH = 400; 
18 private static final int DEFAULT_HEIGHT = 300; 


20 private DefaultMutableTreeNode root; 
21 private DefaultTreeModel model; 
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private JTree tree; 
private JTextField textField; 
private JTextArea textArea; 


public ClassTreeFrame () 
setSize(DEFAULT WIDTH, DEFAULT_HEIGHT) ; 


// the root of the class tree is Object 

root = new DefaultMutableTreeNode(java.lang.Object.class) ; 
model = new DefaultTreeModel (root) ; 

tree = new JTree(model); 


// add this class to populate the tree with some data 
addClass(getClass()); 


// set up node icons 

ClassNameTreeCel]Renderer renderer = new ClassNameTreeCel]Renderer() ; 
renderer.setClosedIcon(new ImageIcon(getClass() .getResource("red-ball.gif"))); 
renderer. setOpenIcon(new ImageIcon(getClass().getResource("yellow-ball.gif"))) ; 
renderer.setLeaflcon(new ImageIcon(getClass() .getResource("blue-ball.gif"))); 
tree. setCel]Renderer (renderer) ; 


// set up selection mode 
tree.addTreeSelectionListener(event -> 
{ 
// the user selected a different node--update description 
TreePath path = tree.getSelectionPath() ; 
if (path == null) return; 
DefaultMutableTreeNode selectedNode = (DefaultMutableTreeNode) path 
.getLastPathComponent () ; 
Class<?> c = (Class<?>) selectedNode.getUserObject() ; 
String description = getFieldDescription(c) ; 
textArea. setText (description) ; 


); 
int mode = TreeSelectionModel .SINGLE_TREE_SELECTION; 
tree.getSelectionModel () .setSelecti onMode(mode) ; 


// this text area holds the class description 
textArea = new JTextArea(); 


// add tree and text area 

JPanel panel = new JPanel (); 

panel .setLayout(new GridLayout(1, 2)); 
panel .add(new JScrol1Pane(tree)) ; 
panel .add(new JScrol]Pane(textArea)) ; 


add(panel, BorderLayout. CENTER) ; 


addTextField(); 
} 


kk 


* Add the text field and "Add" button to add a new class. 
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public void addTextField() 
{ 
JPanel panel = new JPanel(); 


ActionListener addListener = event -> 


{ 
// add the class whose name is in the text field 
try 
{ 
String text = textField.getText(); 
addClass(Class.forName(text)); // clear text field to indicate success 
textField.setText(""); 
} 
catch (ClassNotFoundException e) 
JOptionPane.showMessageDialog(null, "Class not found"); 
} 
ie 


// new class names are typed into this text field 
textField = new JTextField(20); 
textField.addActionListener(addListener) ; 

panel .add(textField) ; 


JButton addButton = new JButton("Add"); 
addButton. addActionListener(addListener) ; 
panel .add(addButton) ; 


add(panel, BorderLayout. SOUTH) ; 


/** 
* Finds an object in the tree. 
* @aram obj the object to find 
* @return the node containing the object or null if the object is not present in the tree 
*/ 
@SuppressWarnings ("unchecked") 
public DefaultMutableTreeNode findUserObject (Object obj) 
{ 
// find the node containing a user object 
Enumeration<TreeNode> e = (Enumeration<TreeNode>) root.breadthFirstEnumeration(); 
while (e.hasMoreE] ements ()) 


DefaultMutableTreeNode node = (DefaultMutableTreeNode) e.nextElement() : 
if (node.getUserObject().equals(obj)) return node: 


return null; 


} 
/** 


* Adds a new class and any parent classes that aren't yet part of the tree 
* @param c the class to add 
* @return the newly added node 
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130 */ 

131 public DefaultMutableTreeNode addClass(Class<?> c) 

32 { 

133 // add a new class to the tree 

134 

135 // skip non-class types 

136 if (c.isInterface() || c.isPrimitive()) return null; 

137 

138 // if the class is already in the tree, return its node 

139 DefaultMutableTreeNode node = findUserObject(c) ; 

140 if (node != null) return node; 

141 

142 // class isn't present--first add class parent recursively 
143 

144 Class<?> s = c.getSuperclass(); 

145 

146 DefaultMutableTreeNode parent; 

147 if (s == null) parent = root; 

148 else parent = addClass (s); 

149 

150 // add the class as a child to the parent 

151 DefaultMutableTreeNode newNode = new DefaultMutableTreeNode(c) ; 
152 model .insertNodeInto(newNode, parent, parent.getChildCount()); 
153 

154 // make node visible 

155 TreePath path = new TreePath(model .getPathToRoot (newNode))) ; 
156 tree.makeVisible(path) ; 

157 

158 return newNode; 

19 } 

160 

161  /** 


162 * Returns a description of the fields of a class. 
163 * @aram the class to be described 
164 * @return a string containing all field types and names 


165 */ 

166 public static String getFieldDescription(Class<?> c) 
7 { 

168 // use reflection to find types and names of fields 
169 StringBuilder r = new StringBuilder(); 

170 Field[] fields = c.getDeclaredFields() ; 

171 for (int i = 0; i < fields. length; i++) 

172 { 

173 Field f = fields[i]; 

174 if ((f.getModifiers() & Modifier.STATIC) != 0) r.append("static "); 
175 r.append(f.getType() .getName()) ; 

176 r.append(" "); 

177 r.append(f.getName()) ; 

178 r.,append("\n"); 

179 

180 return r.toStringQ); 

11 } 
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package treeRender; 


import java.awt.*; 

import java.lang.reflect.*; 
import javax.swing.*; 
import javax.swing.tree.*; 


/** 
* This class renders a class name either in plain or italic. Abstract classes are italic. 
wi 

11 public class ClassNameTreeCellRenderer extends DefaultTreeCel]Renderer 

n { 

13 private Font plainFont = null; 

14 private Font italicFont = null; 


© oOo NN en Aa A u N j 


pen 
© 


16 public Component getTreeCellRendererComponent (JTree tree, Object value, boolean selected, 


17 boolean expanded, boolean leaf, int row, boolean hasFocus) 

18 { 

19 super.getTreeCel]RendererComponent(tree, value, selected, expanded, leaf, row, hasFocus): 
20 // get the user object 

21 Defaul tMutableTreeNode node = (DefaultMutableTreeNode) value; 

22 Class<?> c = (Class<?>) node.getUserObject(); 

23 

24 // the first time, derive italic font from plain font 

25 if (plainFont == null) 

26 { 

27 plainFont = getFont(); 

28 // the tree cell renderer is sometimes called with a label that has a null font 
29 if (plainFont != null) italicFont = plainFont.deriveFont(Font.ITALIO) : 
30 } 

31 

32 // set font to italic if the class is abstract, plain otherwise 

33 if ((c.getModifiers() & Modifier.ABSTRACT) == 0) setFont(plainFont) ; 

34 else setFont(italicFont) ; 

35 return this; 

36 } 

37 } 








e TreePath getSelectionPath() 
èe TreePath[] getSelectionPaths() 

返回 第 一 个 选 定 的 路 径 ， 或 者 一 个 包含 所 有 选 定 节点 的 数组 。 如 果 没 有 选 定 任何 路 径 ， 
这 两 个 方法 都 返回 为 nu11。 


ry t N TRE TEN 3 NO he Oe ey DE OE IA Pip U8 a See = “ate IN SEL Po Rl Ce Ene tie 
A ree thee as ya ail ce em LY 和 2 : 
is Sete E T S EEA A RR Wee eas heey + Sea toes a: ý » ey . 
egy ; Í 





e void valueChanged(TreeSelectionEvent event) 


每 当选 定 节点 或 撤销 选 定 的 时 候 ， 该 方法 就 被 调用 。 
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e TreePath getPath( ) 

ə TreePath[] getPaths() 

获取 在 该 选择 事件 中 已 经 发 生 更 改 的 第 一 个 路 径 或 所 有 路 径 。 如 果 你 想 知 道 当 前 的 选 
择 路 径 ， 而 不 是 选择 路 径 的 更 改 情况 ， 那 么 应 该 调用 JTree.getSelectionPaths, 


10.3.6 定制 树 模型 FR Objectinspectortest 
ee 
在 最 后 一 个 示例 中 》 我 们 实现 a 一 个 能 够 查看 -Dim defaultCloseOperation=1 
恋 量 内 容 的 程序 ， 正 如 调试 器 所 做 的 那样 (参见 图 |; 加 全 RE nore 


— [DY int windowDecorationStye=0 


10-34 ) o — [ class javax. swing. |MenuBar menuBar=null 
在 继续 深入 之 前 ， 请 先 编译 运行 这 个 示例 程序 。 | “Deooew eatonmennseratase ” 

其 中 每 个 节点 对 应 于 一 个 实例 域 。 如 果 该 域 是 一 个 ee tee 

对 象 ， 那 么 可 以 展开 该 节点 以 便 查看 它 自己 的 实例 | E al Component 


域 。 该 程序 会 审视 窗 体 中 的 内 容 。 如 果 你 浏览 了 好 [sl 
几 个 实例 域 ， 那 么 你 将 会 发 现 一 些 熟悉 的 类 ， 还 会 we ees 
对 复杂 的 Swing 用 户 界面 构件 有 所 了 解 。 

该 程序 的 不 同 之 处 在 于 它 的 树 并 没有 使 用 Defau1tTreeMode1。 如 果 你 已 经 拥有 按照 层 
次 结构 组 织 的 数据 ， 那 么 你 可 能 并 不 想 花 精力 去 再 创建 一 棵 副本 树 ， 而 且 创建 副本 树 还 要 扯 
心 怎样 保持 两 棵 树 的 一 致 性 。 这 正 是 我 们 要 讨论 的 情形 ;通过 对 象 的 引用 ， 被 审视 的 对 象 已 
经 彼此 连接 起 来 了 ， 因 此 在 这 里 就 不 需要 复制 这 种 连接 结构 了 。 

TreeModel 接口 具有 几 个 方法 。 第 一 组 方法 使 得 Tree 能 够 按照 先是 根 节 点 ， 后 是 子 
节点 的 顺序 找到 树 中 的 节点 。JTree 类 只 在 用 户 真正 展开 一 个 节点 的 时 候 才 会 调用 这 些 方法 。 


0bject getRoot () 
int getChildCount (Object parent) 
Object getChild(Object parent, int index) 


这 个 示例 显示 了 为 什么 TreeModel 接口 像 JTree 类 那样 ， 不 需要 用 于 描述 节点 的 显 
式 概念 。 根 节点 和 子 节点 可 以 是 任何 对 象 ，TreeMode1 负责 告知 JTree 它们 是 怎样 联系 起 
来 的 。 

TreeModel 接口 的 下 一 个 方法 与 getChi1d 相反 : 

int getIndexOfChild(Object parent, Object child) 

实际 上 ， 这 个 方法 可 以 用 前 面 的 三 个 方法 实现 ， 参 见 程序 清单 10-16 中 的 代码 。 

树 模型 会 告诉 JTree 哪些 节点 应 该 显示 成 叶 节 点 : 


boolean isLeaf(Object node) 


如 果 你 的 代码 更 改 了 树 模型 ， 那 么 必须 告知 这 棵 树 以 便 它 能 够 对 自己 进行 重新 绘制 。 树 
是 将 它 自己 作为 一 个 TreeMode1Listener 添加 到 模型 中 的 ， 因 此 ， 模 型 必须 文 持 通 常 的 监 
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void addTreeModelListener(TreeModelListener 1) 
void removeTreeModelListener(TreeModelListener 1) 


可 以 在 程序 清单 10-17 中 看 到 这 些 方法 的 具体 实现 。 
当 模 型 修改 了 树 的 内 容 时 ， 它 会 调用 TreeMode1Listener 接口 中 下 面 4 个 方法 中 的 某 


一 个 


void treeNodesChanged(TreeModelEvent e) 
void treeNodesInserted(TreeModelEvent e) 
void treeNodesRemoved(TreeModelEvent e) 
void treeStructureChanged(TreeModelEvent e) 


TreeModelEvent 对 象 用 于 描述 修改 的 位 置 。 对 描述 插入 或 移 除 事件 的 树 模 型 事件 进 
” 行 组 淡 的 细节 是 相当 技术 性 的 。 如 果树 中 确实 有 要 添加 或 移 除 的 节点 ， 只 需要 考虑 如 何 触发 
这 些 事件 。 在 程序 清单 10-16 中 ， 我 们 展示 了 怎么 触发 一 个 事件 : 将 根 节点 替换 为 一 个 新 的 
对 象 。 


O 提示 : 为 了 简化 事件 触发 的 代码 ， 我 们 使 用 了 javax.swing.EventListenerList 这 
个 使 用 方便 、 能 够 收集 监听 器 的 类 。 程 序 清 单 10-17 中 最 后 3 个 方法 展示 了 如 何 使 用 这 
个 类 。 

最 后 ， 如 果 用 户 要 编辑 树 节 点 ， 那 么 模型 会 随 着 这 种 修改 而 被 调用 : 

void valueForPathChanged(TreePath path, Object newValue) 

如 果 不 允 许 编辑 ， 则 永远 不 会 调用 到 该 方法 。 

如 果 不 支 持 编辑 功能 ， 那 么 构建 一 个 树 模 型 就 变 得 相当 容易 了 。 我 们 要 实现 下 面 3 个 
方法 ; 

Object getRoot() 


int getChildCount (Object parent) 
Object getChild(Object parent, int index) 


这 3 个 方法 用 于 描述 树 的 结构 。 还 要 提供 另外 5 个 方法 的 常规 实现 ， 如 程序 清单 10-16 
那样 ， 然 后 就 可 以 准备 显示 你 的 树 了 。 

现在 让 我 们 转向 示例 程序 的 具体 实现 ,我们 的 树 将 包含 类 型 为 Variable 的 对 象 。 
注意 : 一 旦 使 用 了 Defau1tTreeMode1， 我 们 的 节点 就 可 以 具有 类 型 为 DefaultMutable- 

TreeNode、 用 户 对 象 类 型 为 Variable 的 对 象 。 

例如 ， 假 设 我 们 查看 下 面 这 个 变量 

Employee joe; 

该 变量 的 类 型 为 Emp1oyee .class， 名 字 为 joe， 值 为 对 象 引 用 joe 的 值 。 在 程序 清 
单 10-18 中 ,我们 定义 了 Variable 这 个 类 ， 用 来 描述 程序 中 的 变量 ; 


Variable v = new Variable(Employee.class, "joe", joe); 
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new Variable(double.class, "Salary", new Double(salary)) ; 


如 果 变 量 的 类 型 是 一 个 类 ， 那 么 该 变量 就 会 拥有 一 些 域 。 使 用 反射 机 制 可 以 将 所 有 域 枚 
举 出 来 ， 并 将 它们 收集 存放 到 一 个 ArrayList 中 。 因 为 Class 类 的 getFields 方法 不 返 
回 超 类 的 任何 域 ， 因 此 还 必须 调用 超 类 中 的 getFields 方法 ， 你 可 以 在 Variable 构造 项 
中 找到 这 些 代 码 。Variable 类 的 getFields 方法 将 返回 一 个 包含 了 各 类 域 的 一 个 数组 。 最 
后 ，Variable 类 的 toString 方法 将 节点 格式 化 为 标签 ， 这 个 标签 通常 包含 变量 的 类 型 和 
名 称 。 如 果 变 量 不 是 一 个 类 ， 那 么 该 标签 还 将 包含 变量 的 值 。 


注意 : 如 果 类 型 是 一 个 数组 ， 那 么 我 们 不 会 显示 数组 中 的 元 素 。 这 并 不 难 实现 ， 因 此 我 
们 就 把 它 留 作 众所周知 的 “读者 练习 ”了 。 


让 我 们 继续 介绍 树 模型 ， 头 两 个 方法 很 简单 。 
public Object getRoot () 


return root; 


} 
public int getChildCount (Object parent) 


return ((Variable) parent) .getFields().size(); 


getChi1d 方 法 返回 一 个 新 的 Variable 对 象 ， 用 于 描述 给 定 索 引 位 置 上 的 域 。 
Fie1d 类 的 getType 方 法 和 getName 方 法 用 于 产生 域 的 类 型 和 名 称 。 通 过 使 用 反射 机 
制 ， 你 可 以 按照 f.get(parentValue) 这 种 方式 读 取 域 的 值 。 该 方法 可 以 抛 出 一 个 异常 
I11ega1AccessException， 不 过 ， 我 们 可 以 让 所 有 域 在 Variable 构造 器 中 都 是 可 访问 
的 ， 这 样 ， 在 实际 应 用 中 ， 就 不 会 发 生 这 种 抛 异 常 的 情况 。 

下 面 是 getChi1d 方 法 的 完整 代码 。 


public Object getChild(Object parent, int index) 

{ 
ArrayList fields = ((Variable) parent).getFields(); 
Field f = (Field) fields. get (index) ; 
Object parentValue = ((Variable) parent) .getValue() ; 
try 


return new Variable(f.getType(), f.getName(), f.get(parentValue)) ; 
catch (I]legalAccessException e) 
return null; 


} 
这 3 个 方法 展示 了 对 象 树 到 JTree 构件 之 间 的 结构 ， 其 余 的 方法 是 一 些 常 规 方法 ， 源 代 
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码 请 见 程序 清单 10-17. 
关于 该 树 模型 ， 有 一 个 不 同 寻 常 之 处 : 它 实 际 上 描述 的 是 一 棵 无 限 树 。 可 以 通过 追踪 
WeakReference 对 象 来 证 实 这 一 点 。 当 你 点 击 名 字 为 referent 的 变量 时 ， 它 会 引导 你 回 
到 初始 的 对 象 。 你 将 获得 一 棵 相同 的 子 树 ， 并 且 可 以 再 次 展开 它 的 WeakReference 对 象 ， 
周而复始 ， 无 穷 无 尽 。 当 然 ， 你 无 法 存储 一 个 无 限 的 节点 集合 。 树 模型 只 是 在 用 户 展开 父 节 
点 时 ， 按 照 需要 来 产生 这 些 节点 。 
程序 清单 10-16 展示 了 样 例 程序 的 框 体 类 。 





package treeModel ; 
import java.awt.*; 
import javax. swing. *; 





/** 

* This frame holds the object tree. 

= 

public class ObjectInspectorFrame extends JFrame 
10 { 
ll private JTree tree; 

12 private static final int DEFAULT_WIDTH = 400; 
13 private static final int DEFAULT_HEIGHT = 300; 
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15 public ObjectInspectorFrame() 


17 setSize(DEFAULT_WIDTH, DEFAULT_HEIGHT) ; 

18 

19 // we inspect this frame object 

20 

21 Variable v = new Variable(getClass(), "this", this); 
22 ObjectTreeModel model = new ObjectTreeModel () ; 
23 model .setRoot(v) ; 

24 

25 // construct and show tree 

26 

27 tree = new JTree(model); 

28 add(new JScrol]Pane(tree), BorderLayout.CENTER) ; 
29 } 

30 } 





package treeModel ; 


import java.lang.reflect.*; 
import java.util.*; 

import javax.swing.event.*; 
import javax.swing.tree.*: 
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8 [** 
* This tree model describes the tree structure of a Java object. Children are the objects that 
* are stored in instance variables. 


9 
10 


public class ObjectTreeModel implements TreeModel 


{ 


private Variable root; 
private EventListenerList listenerList = new EventListenerList() ; 


/** 
* Constructs an empty tree. 
a 


public ObjectTreeModel () 
{ 


root = null; 


} 


/[** 
* Sets the root to a given variable. 


* @param v the variable that is being described by this tree 
* 


public void setRoot(Variable v) 


Variable oldRoot = v; 

root = V; 

fireTreeStructureChanged (oldRoot); 
} 


public Object getRoot() 
{ 


return root; 


} 
public int getChildCount (Object parent) 


return ((Variable) parent) .getFields().sizeQ); 
} 


public Object getChild(Object parent, int index) 
{ 
ArrayList<Field> fields = ((Variable) parent) .getFields(); 
Field f = (Field) fields.get (index) ; 
Object parentValue = ((Variable) parent) .getValue(); 
try 
{ 


return new Variable(f.getType(), f.getName(), f.get(parentValue)) ; 


catch (I]legalAccessException e) 


return null; 
} 
} 


public int getIndexOfChild(Object parent, Object child) 
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62 { 

63 int n = getChildCount (parent) ; 

64 for (int i = 0; i < n; i++) 

65 if (getChild(parent, i).equals(child)) return i; 
66 return -1; 

67 } 

68 

69 public boolean isLeaf (Object node) 

70 { 

71 return getChildCount(node) == 0; 

72 } 

73 

74 public void valueForPathChanged(TreePath path, Object newValue) 
75 

76 } 

77 

78 public void addTreeModelListener(TreeModelListener 1) 

79 

80 listenerList.add(TreeModelListener.class, 1); 

81 } 

82 

83 public void removeTreeModelListener(TreeModelListener 1) 
84 

85 listenerList. remove(TreeModelListener.class, 1); 

86 } 

87 

88 protected void fireTreeStructureChanged (Object oldRoot) 
89 

90 TreeModelEvent event = new TreeModelEvent(this, new Object[] { oldRoot }); 
91 for (TreeModelListener 1 : listenerList.getListeners(TreeModelListener.class)) 
92 ].treeStructureChanged (event) ; 

93 } 

94 } 






1 package treeModel; 


import java.lang.reflect.*; 
import java.util.*: 


3 
4 

5 

6 /** 
7 * A variable with a type, name, and value. 
E %4 

9 public class Variable 

11 private Class<?> type; 

12 private String name; 

13 private Object value; 

14 private ArrayList<Field> fields; 


16 /** 
17 * Construct a variable. 
18 * @param aType the type 
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* @param aName the name 


* @param aValue the value 
* 


public Variable(Class<?> aType, String aName, Object aValue) 


{ 
type = alype; 
name = aName; 
value = aValue; 
fields = new ArrayList<>Q); 


// find all fields if we have a class type except we don't expand strings and null values 
if (Itype.isPrimitive() && !type.isArray() && !type.equals(String.class) && value != null) 


// get fields from the class and all superclasses 
for (Class<?> c = value.getClass(); c != null; c = c.getSuperclass()) 


Field[] fs = c.getDeclaredFields(); 
AccessibleObject.setAccessible(fs, true); 


// get all nonstatic fields 
for (Field f : fs) 
if ((f.getModifiers() & Modifier.STATIC) == 0) fields.add(f); 


} 
} 


[** 

* Gets the value of this variable. 
* @return the value 

ay 


public Object getValue() 
{ 


return value; 


} 


[** 

* Gets all nonstatic fields of this variable. 

* @return an array list of variables describing the fields 
| 


public ArrayList<Field> getFields() 


return fields: 


} 


public String toString() 

{ 
String r = type + " " + name; 
if (type.isPrimitive()) r += + value; 
else if (type.equals(String.class)) r += 
else if (value == null) r += "=null"; 
return r; 


+ value; 
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e Object getRoot() 
返回 根 节点 。 
e int getChildCount(Object parent) 
获取 parent 节点 的 子 节点 个 数 。 
è Object getChild(Object parent, int index) 
获取 给 定 索引 位 置 上 parent 节点 的 子 节点 。 
e int getIndexOfChild(Object parent, Object child) 
KM parent 节点 的 子 节 点 child 的 索引 位 置 。 如 果 在 树 模型 中 child 节点 不 是 
parent 的 一 个 子 节点 ， 则 返回 -1。 
e boolean isLeaf(Object node) 
如 果 节 点 node 从 概念 上 讲 是 一 个 叶 节 点 ， 则 返回 true, 
evoid addTreeModelListener(TreeModelListener 1) 
e void removeTreeModelListener(TreeModelListener 1) 
当 模型 中 的 信息 发 生变 化 时 ， 告 知 添加 和 移 除 监 听 器 。 
e void valueForPathChanged(TreePath path, Object newValue) 
当 一 个 单元 格 编辑 器 修改 了 节点 值 的 时 候 ， 该 方法 被 调用 。 


参数 : path 到 被 编辑 节点 的 树 路 径 


newValue 编辑 器 返回 的 修改 值 








e void treeNodesChanged(TreeModelEvent e) 
e void treeNodesInserted(TreeModelEvent e) 

e void treeNodesRemoved(TreeModelEvent e) 

e void treeStructureChanged(TreeModelEvent e) 


如 果树 被 修改 过 ， 树 模型 将 调用 该 方法 。 









e TreeModelEvent(Object eventSource, TreePath node) 
构建 一 个 树 模型 事件 。 
参数 : eventSource 产生 该 事件 的 树 模型 
node 到 达 要 修改 节点 的 树 路 径 


10.4 ”文本 构件 


图 10-35 展示 了 Swing 类 库 中 包含 的 所 有 文本 构件 ， 在 卷 1 第 9 章 你 已 经 看 到 过 其 中 3 
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个 最 常用 的 构件 : JTextField, JPasswordField Al JTextArea, Æ FMA it, RITS 
介绍 其 余 的 文本 构件 。 我 们 还 将 讨论 JSpinner 构件 ， 它 包含 一 个 格式 化 的 文本 框 ， 以 及 用 
来 改变 其 内 容 的 “up (上 )” 和 “down (下 ) 小 按钮 。 
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图 10-35 文本 构件 和 文档 的 层次 结构 


所 有 文本 构件 都 可 以 绘制 和 编辑 存储 在 实现 了 Document 接口 的 类 的 模型 对 象 中 的 数 
据 。JTextField 和 JUTextArea 构件 使 用 的 是 P1ainDocument ， 该 构件 直接 存储 普通 文本 
的 行 序列 ， 而 不 进行 任何 格式 化 。 

JEditorPane 可 以 展示 和 编辑 各 种 格式 的 样式 文本 (包括 字体 、 颜 色 等 )， 特 别 是 
HTML, ÆJ 10.4.4 节 ，StyledDocument 接口 描述 了 对 样式 、 字 体 和 颜色 的 额外 需求 ， 而 
HTMLDocument 类 实现 了 这 个 接口 。 

JEditorPane 的 子 类 JTextPane 可 以 持 有 样式 化 的 文本 和 骨 入 的 Swing 构件 。 我 们 在 
本 书 中 将 不 讨论 过 于 复杂 的 JTextPane, 但 是 推荐 你 参考 Kim Toley 所 著 的 《 Core Swing ) 
一 书 以 了 解 其 中 关于 此 构件 十 分 详细 的 描述 。 对 于 JTextPane 类 的 典型 用 法 ， 可 以 查看 
JDK 中 的 StylePad 演示 程序 。 


10.4.1 文本 构件 中 的 修改 跟踪 


只 有 当 你 希望 实现 自己 的 文本 编辑 器 时 ， 你 才 需 要 面 对 Document 接口 的 复杂 性 。 然 而 ， 
这 个 接口 的 最 常见 的 用 法 是 : 跟踪 修改 。 

有 时 ， 你 希望 只 要 用 户 进行 了 文本 编辑 ， 无 需 等 待 他 点 击 某 个 按钮 ， 就 马上 更 新 部 分 用 
户 界 面 。 下 面 是 一 个 简单 的 示例 : 我 们 显示 了 三 个 文本 框 ， 用 于 编辑 颜色 的 红 、 蓝 、 绿 色调 。 
只 要 这 些 文本 框 的 内 容 发 生 了 变化 ， 颜 色 就 应 该 立即 更 新 。 图 10-36 展示 了 程序 清单 10-19 
中 的 程序 运行 起 来 的 样子 。 





550 Java ZSRR All BRA 






POSER AT PTT 


图 10-36 ”跟踪 文本 框 中 的 修改 


首先 请 注意 ， 监 视 键盘 点 击 事件 并 非 好 主意 ， 因 为 有 些 键 盘点 击 事件 并 不 修改 文本 ( 例 
如 ， 点 击 方向 键 )。 更 重要 的 是 ， 文本 可 以 因 鼠 标的 姿态 变化 而 改变 (例如 在 X11 PA 
标 中 键 粘 贴 ”)。 因 此 ， 应 该 让 文档 (document) 来 通知 我 们 数据 发 生 了 变化 ,方法 是 在 文档 
(而 不 是 文本 构件 ) 上 安装 文档 监听 器 (document listener): 


textField.getDocument() .addDocumentListener(listener); 


当 文 本 发 生变 化 时 ， 会 调用 下 列 DocumentListener 方法 之 一 : 


void insertUpdate(DocumentEvent event) 
void removeUpdate(DocumentEvent event) 
void changedUpdate(DocumentEvent event) 


前 两 个 方法 是 在 插 人 或 移 除 字符 时 被 调用 的 ， 第 三 个 方法 对 于 文本 框 来 说 根本 不 会 被 调 
用 ， 而 对 于 更 复杂 的 文档 类 型 ， 在 产生 某 些 其 他 类 型 的 变化 ， 例 如 格式 上 的 变化 时 ， 这 个 方 
法 才 会 被 调用 。 但 是 ， 由 于 没有 任何 单个 的 回调 可 以 告诉 我 们 文本 发 生 了 变化 (通常 我 们 也 
并 不 太 关 心 文本 发 生 了 怎样 的 变化 )， 同 时 也 没有 任何 适 配 絮 类 ， 因 此 ， 文 档 监 听 右 必须 实现 
所 有 这 3 个 方法 。 下 面 是 我 们 在 示例 程序 中 的 做 法 : 


DocumentListener listener = new DocumentListener() 
{ 
public void insertUpdate(DocumentEvent event) { setColor(); } 
public void removeUpdate(DocumentEvent event) { setColor(); } 
public void changedUpdate(DocumentEvent event) {} 
} 


setColor 方法 使 用 getText 方法 从 文本 框 中 获得 当前 的 用 户 输 入 字符 串 ， 并 设置 其 颜色 。 

我 们 的 程序 有 一 个 限制 : 用 户 可 以 在 文本 框 中 键入 非 数字 的 畸形 输入 ， 例 如 
“twenty”， 或 者 使 文本 框 保持 为 空 。 因 此 ， 目 前 我 们 将 捕获 parseInt 方 法 抛 出 的 
NumberFormatException， 并 且 在 文本 框 中 的 内 容 不 是 数字 时 ， 不 执行 更 新 颜色 的 操作 。 
在 下 一 节 ， 你 将 会 看 到 可 以 如 何 预先 防止 用 户 键入 无效 的 输入 。 


注意 : 除了 监听 文档 事件 ， 还 可 以 在 文本 框 上 添加 一 个 行为 事件 监听 器 。 只 要 用 户 按 下 
了 回 车 键 ， 动 作 监 听 器 就 会 得 到 通知 。 我 们 不 推荐 这 种 方法 ， 因 为 用 户 在 完成 数据 输入 
后 ， 并 非 总 是 记得 按 回 车 键 。 如 果 使 用 动作 监听 器 ， 就 应 该 同时 安装 一 个 焦点 监听 器 ， 
这 样 我 们 可 以 跟踪 用 户 何 时 离开 该 文本 框 。 






1 package textChange; 

2 

3 import java.awt.*; 

4 import javax.swing.*; 
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5 import javax.swing.event.*; 

: 

7 /** 

s * A frame with three text fields to set the background color. 
g */ 

10 public class ColorFrame extends JFrame 
u { 

12 private JPanel panel; 

13 private JTextField redField; 

14 private JTextField greenField; 

15 private JTextField blueField; 


17 public ColorFrame() 


18 { 

19 DocumentListener listener = new DocumentListener() 

20 { 

21 public void insertUpdate(DocumentEvent event) { setColor(); } 
22 public void removeUpdate(DocumentEvent event) { setColor(); } 
23 public void changedUpdate(DocumentEvent event) {} 

24 p 

25 

26 panel = new JPanel (); 

27 

28 panel .add(new JLabel("Red:")); 

29 redField = new JTextField("255", 3); 

30 panel .add(redField) ; 

31 redField.getDocument () .addDocumentLi stener (listener); 

32 

3 panel .add(new JLabel ("Green:")); 

34 greenField = new JTextField("255", 3); 

35 panel] .add(greenField) ; 

36 greenField.getDocument() .addDocumentListener(listener) ; 

37 

38 panel.add(new JLabel ("Blue:")); 

39 blueField = new JTextField("255", 3); 

40 panel .add(blueField); 

41 blueField.getDocument () .addDocumentListener(]istener) ; 

42 

43 add (panel); 

44 pack(); 

4s} 

46 

47 kx 

48 * Set the background color to the values stored in the text fields. 
49 */ 

so public void setColor() 

51 { 

52 try 

53 { 

54 int red = Integer.parseInt(redField.getText().trim()); 

55 int green = Integer.parseInt(greenField.getText() .trim()); 
56 int blue = Integer. parseInt(blueField.getText() .trim(Q); 
57 panel .setBackground(new Color(red, green, blue)); 
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59 catch (NumberFormatException e) 
60 
61 // don't set the color if the input can't be parsed 





e Dimension getPreferredSize( ) 


evoid setPreferredSize(Dimension d) 


获取 和 设置 该 构件 的 偏好 尺寸 。 


AL SIS Cae ie TEES 
am] javax.swing.1 „tex ext. Document 1.2 


> 





e int getLength() 
返回 文档 中 当前 的 字符 数量 。 
e String getText(int offset, int length) 
返回 在 文档 的 给 定 部 分 中 所 包含 的 文本 。 
参数 :, offset ”文本 的 起 始 位 置 
length ”希望 得 到 的 字符 串 的 长 度 
e void addDocumentListener(DocumentListener listener) 


注册 监听 器 ， 使 得 在 文档 发 生变 化 时 ， 可 以 得 到 通知 。 


se) 
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e Document getDocument( ) 


获取 事件 来 源 的 文档 。 





e void diangen tetionument Eveni event) 
当 某 个 属性 或 属性 集 发 生变 化 时 ， 该 方法 即 被 调用 。 

e void insertUpdate(DocumentEvent event) 
在 文档 中 插入 内 容 时 ， 该 方法 即 锌 调用 。 


e void ot a event) 


在 文档 中 有 部 分 内 容 被 移 除 时 ， 该 方法 即 被 调用 。 


10.4.2 格式 化 的 输入 框 


在 前 一 个 示例 程序 中 ， 我 们 希望 程序 的 用 户 键 人 数字 而 不 是 任意 的 字符 串 。 也 就 是 说 ， 
只 允许 用 户 键 入 数字 0 ~ 9 以 及 连 字符 ， 并 且 如 果 有 连 字 符 ， 它 必须 是 输入 字符 串 的 第 一 个 


oO 


W 
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表面 上 看 ， 这 种 输入 检验 任务 很 简单 。 我 们 可 以 在 文本 框 上 安装 一 个 按键 监听 器 ， 然 后 
处 理 掉 所 有 不 是 数字 和 连 字符 的 按键 事件 。 但 是 ， 这 种 简单 的 方法 在 实践 中 并 非 很 有 效 ， 尽 
管 这 是 通常 被 推荐 的 输入 检验 方法 。 首 先 ， 并 非 每 一 种 有 效 输 入 字符 的 组 合 都 是 一 个 有 效 的 
数字 ， 例 如 ，--3 和 3-3 都 无 效 ， 尽 管 它们 是 由 有 效 的 输入 字符 构成 的 。 但 是 ， 更 重要 的 是 ， 
有 些 对 文本 修改 的 方式 并 不 涉及 输入 字符 键 。 根 据 不 同 的 用 户 界 面 感 观 ， 某 些 组 合 键 可 以 用 
来 剪 切 、 复 制 和 粘贴 文本 。 例 如 ， 在 金属 用 户 界面 感 观 中 ，CTRL+V 组 合 键 可 以 将 粘贴 缓冲 
区 中 的 内 容 粘 贴 到 文本 框 中 。 也 就 是 说 ， 我 们 还 需要 监视 用 户 是 否 粘贴 了 无 效 的 字符 。 很 明 
显 ， 试 图 通过 过 波 键 盘点 击 来 确保 文本 框 的 内 容 总 是 有 效 这 种 方法 看 起 来 已 经 很 麻烦 了 ， 而 
这 些 任务 并 不 应 该 让 应 用 系统 的 程序 员 去 关注 。 

有 点 令 人 惊讶 的 是 ， 在 Java SE 1.4 之 前 ， 没 有 任何 构件 用 于 输入 数字 型 的 值 。 从 《 Core 
Java 》 的 第 1 版 开始 ， 我 们 就 提供 了 一 个 IntTextFie1d 实现 ， 这 是 一 个 用 于 输入 正确 格式 
的 整数 的 文本 框 。 在 此 后 的 每 个 新 版 本 中 ， 我 们 都 在 修改 这 个 实现 ， 以 利用 Java 在 其 每 个 新 
版 本 中 不 断 添加 的 各 种 不 太 全 面 的 校 验 模式 。 最 终 ， 在 Java SE 1.4 中 ，Swing 的 设计 者 们 正 
视 了 这 个 问题 ,并且 提供 了 通用 的 UFormattedTextField 类 ， 它 不 仅 可 以 用 于 数字 型 的 输 
入 ， 而 且 可 以 用 于 日 期 型 输入 以 及 更 加 专用 的 格式 化 输入 值 ， 例 如 IP 地 址 。 

1. 整数 输入 

让 我 们 从 简单 的 情况 入 手 : 用 于 整数 输入 的 文本 框 


JFormattedTextField intField = new JFormattedTextField(NumberFormat.getIntegerInstance()) ; 


NumberFormat. getIntegerInstance 将 使 用 当前 的 locale 返回 一 个 用 于 格式 化 整数 
的 格式 器 对 象 。 在 美国 locale 中 ， 逗 号 用 作 十 进 制 分 隅 待 ， 从 而 允许 用 户 输入 像 1,729 这 样 
的 值 。 第 7 章 详细 解释 了 如 何 选择 其 他 的 locale。 

对 于 任何 文本 框 ， 都 可 以 设置 其 位 数 : 

intField.setColumns (6) ; 

还 可 以 用 setValue 方法 设置 其 默认 值 ， 该 方法 接受 一 个 0bject 类 型 的 参数 ， 因 此 我 
们 需要 将 默认 的 int 值 包装 到 一 个 Integer 对 象 中 : 

intField.setValue(new Integer(100)); 


通常 ， 用 户 会 在 多 个 文本 框 中 输入 ， 然 后 点 击 某 个 按钮 来 读 取 所 有 这 些 值 。 当 按钮 被 
点 击 后 ， 可 以 用 getValue 方法 来 获取 用 户 提 供 的 值 ， 这 个 方法 返回 的 是 一 个 Object 类 
型 的 结果 ， 必 须 将 它 转型 为 恰当 的 类 型 。 如 果 用 户 对 上 述 文本 框 中 的 值 进行 了 编辑 ， 那 么 
JFormattedTextField 将 返回 Long 类 型 的 对 象 。 但 是 ， 如 果 用 户 没 有 进行 修改 ， 就 会 返 
回 最 初 的 Integer 对 象 。 因 此 ， 应 该 将 返回 值 转型 为 它们 的 公共 超 类 Number; 


Number value = (Number) intField.getValue(); 
int v = value.intValue(); 


格式 化 文本 框 看 上 去 可 能 并 没什么 太 大 的 用 处 ， 但 是 如 果 你 要 考虑 用 户 提供 非法 输入 时 
的 情况 ， 那 么 它 就 有 用 处 了 ， 这 正 是 下 一 的 主题 。 
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2. 失去 焦点 时 的 行为 

考虑 一 下 当 用 户 向 文本 框 中 输入 时 会 发 生 什 么 。 用 户 键 人 输入， 并 且 在 完成 后 决定 离开 
这 个 文本 框 ， 因 此 可 能 会 用 鼠标 点 击 其 他 的 构件 ， 然 后 这 个 文本 框 将 失去 焦点 (lose focus), 
在 其 中 不 再 会 看 到 像 1 一样 的 闪烁 光标 ， 键 盘点 击 都 将 被 导 问 男 一 个 不 同 的 构件 。 

当 格 式 化 文本 框 失 去 焦点 时 ， 格 式 融 会 查看 用 户 输 入 的 文本 字符 串 。 如 果 格 式 右 知道 如 
何 将 这 个 文本 字符 串 转换 为 对 象 ， 那 么 这 个 文本 就 是 有 效 的 ， 否 则 就 是 无 效 的 。 可 以 使 用 
isEditValid 方法 来 检查 文本 框 的 当前 内 容 是 否 有 效 。 

失去 焦点 的 默认 行为 称 为 “提交 或 恢复 ”。 如 果 文 本 字符 串 有 效 ， 则 它 被 提交 (commit), 
之 后 格式 器 将 其 转换 为 对 象 ， 而 该 对 象 将 成 为 文本 框 的 当前 值 (也 就 是 前 一 节 中 提 到 的 
getValue 方法 的 返回 值 )。 这 个 值 然 后 再 被 转换 回 字 符 串 ， 成 为 在 文本 框 中 看 到 的 字符 串 。 
例如 ， 整 数 格式 器 将 输入 的 1729 识别 为 有 效 ， 将 当前 值 设置 为 new Long(1729)， 然 后 将 
其 转换 回 带 有 十 进 制 逗号 的 字符 串 1,729。 

反之 ， 如 果 文 本 字符 串 无 效 ， 则 当前 值 不 发 生变 化 ， 而 文本 框 将 恢复 到 表示 原 有 值 的 字 
符 串 。 例 如 ， 如 果 用 户 输入 了 无 效 值 ， 例 如 x1， 和 那么 当 文 本 框 失去 焦点 时 ， 将 恢复 原 有 值 。 


注意 : 整数 格式 器 将 以 整数 开头 的 文本 字符 串 当 作 是 有 效 的 。 例 如 ，1729x 是 有 效 的 字 

符 串 ， 它 将 被 转换 为 数字 1729， 这 个 数字 之 后 会 被 格式 化 为 字符 串 1,729。 

可 以 用 setFocusLostBehavior 方法 来 设置 其 他 的 行为 。 “提交 ”行为 与 默认 行为 有 些 
细微 的 差异 ， 如 果 文 本 字符 串 无 效 ， 那 么 文本 字符 串 和 文本 框 的 值 都 将 保持 不 变 ， 现 在 它们 
是 不 同步 的 。“ 持 久 化 ”行为 更 加 保守 ， 即 使 文本 字符 串 是 有 效 的， 文本 框 和 当前 值 也 都 不 
发 生变 化 ， 这 时 需要 调用 commitEdit、setValue 和 setText 来 使 它们 同步 。 最 后 ， 还 有 
一 个 “恢复 ”行为 ， 它 看 起 来 永远 都 没什么 用 ， 其 行为 是 只 要 失去 了 焦点 ， 用 户 输入 就 会 被 
丢弃 ， 而 文本 字符 串 将 恢复 到 原 有 值 。 


注意 : 通常 , “提交 或 恢复 ”作为 默认 行为 是 合理 的 ， 这 么 做 只 有 一 个 潜在 可 能 发 生 的 问题 。 
假设 对 话 框 中 包含 用 于 整数 值 的 文本 框 ， 而 用 户 输入 了 字符 串 “ 1729”， 其 中 带 一 个 先导 
的 空格 ， 然 后 点 击 了 OK 按钮 。 这 个 先导 的 空格 将 会 使 数字 无 效 ， 而 这 个 文本 框 的 值 也 将 
恢复 到 原 有 值 。 接 着 ，OK 按钮 的 动作 监听 器 获取 文本 框 的 值 ， 然 后 关闭 对 话 框 。 这 样 用 
户 永远 都 不 会 知道 他 输入 的 新 值 被 拒绝 了 。 在 这 种 情况 下 ,恰当 的 选择 应 该 是 “提交 ” 行 
为 ， 然 后 让 OK 按钮 的 监听 器 在 关闭 对 话 框 之 前 检查 所 有 的 文本 框 编 辑 是 否 都 有 效 。 


格式 化 文本 框 的 基本 功能 对 于 大 多 数 用 户 来 说 很 直观 ， 而 且 也 足够 用 了 。 但 是 ， 我 们 还 
可 以 添加 一 些 精 化 的 功能 ， 例 如 同时 还 要 防止 用 户 键入 非 数 字 字 符 ， 我 们 可 以 用 文档 过 滤器 
(document filter) 来 实现 这 个 行为 。 回 忆 一 下 ， 在 模型 - 视图 - 控制 器 架构 中 ， 控 制 器 将 输 
和 人 事件 转译 成 了 修改 文本 框 底层 文档 的 命令 ， 这 个 底层 文档 也 就 是 存储 在 PlainDocument 
对 象 中 的 文本 字符 串 。 例 如 ， 每 当 控制 器 处 理 的 命令 会 导致 在 该 文档 中 搬 人 字符 串 时 ， 它 
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就 会 调用 “插入 字符 串 ” 命 令 。 要 插入 的 字符 串 可 以 是 单个 的 字符 ， 也 可 以 是 粘贴 缓冲 区 
中 的 内 容 。 文 档 过 滤器 可 以 拦截 这 个 命令 ， 并 修改 字符 串 或 放弃 插入 操作 。 下 面 是 过 滤 冀 
的 insertString 方法 的 代码 ， 该 方法 对 要 插入 的 字符 串 进行 分 析 ， 并 只 插入 那些 数字 和 
负 号 (-) 字符 。( 这 有 段 代码 可 以 处 理 卷 1 第 3 章 中 描述 的 补充 Unicode 字符 ， 请 参见 第 1 章 
StringBuilder 类 。) 
public void insertString(FilterBypass fb, int offset, String string, AttributeSet attr) 
throws BadLocationException 


StringBuilder builder = new StringBuilder(string) ; 
for (int 1 = builder. length() - 1; 1 >= 0; 1--) 


int cp = builder. codePointAt(1) ; 
if (!Character.isDigit(cp) && cp != '-') 


builder.deleteCharAt (i) ; 
if (Character. isSupp]ementaryCodePoint (cp) ) 
{ 
Lesa 
builder.deleteCharAt (i); 
} 
} 
} 
super.insertString(fb, offset, builder.toString(), attr); 


} 

还 应 该 覆盖 DocumentFilter 类 的 replace TE, WATE TEMA LE P HE T i 
FAA. replace 方法 的 实现 很 直观 ， 参 见 程序 清单 10-21. 

现在 需要 安装 文档 过 滤器 。 但 是 ， 没 有 很 直观 的 方法 可 以 实现 这 个 任务 ， 必 须 履 
盖 某 个 格式 器 类 的 getDocumentFilter 方 法 ， 然 后 将 这 个 格式 器 的 一 个 对 象 传递 给 
JFormattedTextFiel1d。 整 数 文本 框 使 用 的 是 用 NumberFormat .getIntegerInstance( ) 
初始 化 的 Internationa1Formatter。 下 面 展 示 了 如 何 安装 格式 器 以 产生 所 需 的 过 滤 厨 : 

JFormattedTextField intField = new JFormattedTextField(new 

International Formatter (NumberFormat .getIntegerInstance() ) 


private DocumentFilter filter = new IntFilter(); 
protected DocumentFilter getDocumentFilter() 


return filter; 
} 
让 


注意 : Java SE 文档 声明 DocumentFilter 类 被 设计 为 禁止 子 类 化 。 直 到 Java SE 1.3, 
文本 框 中 的 过 滤 机 制 才 通过 扩展 PlainDocument £4#e# 4S insertString 5 replace 
方法 得 到 了 实现 。 现 在 ，P1ainDocument 类 有 了 可 播 拔 的 过 滤器 ， 这 是 一 项 极 佳 的 改 
进 。 如 果 过 滤器 在 格式 器 类 中 也 是 可 插 拔 的 ， 那 么 这 项 改进 就 更 好 了 。 唉 ， 但 是 它 不 是 ， 
我 们 必须 子 类 化 格式 器 。 
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试验 一 下 本 节 最 后 的 FormatTest RAMEY, HP =P OCA ee SPRUE a, 
这 样 就 只 能 插入 数字 和 负 号 字符 了 。 注 意 ， 现 在 你 仍旧 可 以 键入 诸如 “1-2-3” 这 样 的 无 效 字 
符 串 。 通 常 ， 通 过 过 滤 机 制 来 避免 所 有 无 效 字符 串 是 不 可 能 的 。 例 如 ， 字 符 串 “-” 是 无 效 
的 ， 但 是 过 滤 需 不 能 拒绝 它 ， 因 为 它 是 合法 字符 串 “-1” 的 前 缀 。 即 使 过 滤器 不 能 进行 完美 
的 保护 ， 但 是 使 用 它们 来 拒绝 明显 无 效 的 输入 仍旧 是 有 意义 的 。 


C 提示 : 过 滤 机 制 的 另 一 种 用 法 是 将 一 个 字符 串 的 所 有 字符 都 转 为 大 写 。 这 样 的 过 滤器 很 
Sym, HH insertString 和 replace 方 法 中 ,将 要 插入 的 字符 串 转 换 成 大 写 ， 
然后 调用 超 类 的 方法 即 可 。 


4. Baw es 

还 有 一 种 很 有 用 的 机 制 ， 可 以 就 无 效 输入 对 用 户 发 出 警告 ， 这 就 是 可 以 在 任意 的 
JComponent 上 附着 一 个 校 验 器 〈veriftier)。 如 果 该 构件 失去 了 焦点 ， 那 么 校 验 需 就 会 被 查 
询 。 如 果 校 验 需 报告 该 构件 的 内 容 无 效 ， 那 么 该 构件 就 会 立即 重新 获得 焦点 。 这 样 AP at 
被 强制 要 求 在 进行 其 他 输入 之 前 先 订 正 刚 输入 的 内 容 。 

Mindray KE InputVerifier 类 并 定义 verify 方法 ， 而 定义 检查 格式 化 文本 框 的 
校 验 器 非常 容易 。JFormattedTextField 类 的 isEditValid FIER, FFA 
格式 器 可 以 将 文本 字符 串 转 换 为 对 象 时 返回 true, PF MAP RG: 


intField.setInputVerifier(new InputVeri fier() 
public boolean verify(JComponent component) 


JFormattedTextField field = (JFormattedTextField) component; 
return field.isEditValid(); 
} 
}); 


我 们 可 以 将 它 附着 到 任何 UF ormattedTextField E, 

在 示例 程序 中 的 第 四 个 文本 框 就 附着 了 一 个 校 验 器 。 试 着 在 其 中 键入 无 效 数字 (例如 
x1729)， 然 后 按 下 TAB 键 ,或 者 用 鼠标 点 击 其 他 文本 框 。 注 意 ， 该 文本 框 会 立即 重新 得 到 
焦点 。 但 是 ， 如 果 你 点 击 OK 按钮 ， 动 作 监 听 顺 就 会 调用 getValue， 它 会 报告 最 后 一 个 有 
效 值 。 | 

但 是 ， 校 验 器 并 非 总 是 很 安全 。 如 果 点 击 了 某 个 按钮 ， 而 这 个 按钮 在 无 效 构件 再 次 获得 
焦点 之 前 通知 了 它 的 动作 监听 器 ， 那 么 这 个 动作 监听 器 就 会 从 未 通过 校 验 的 构件 中 得 到 一 个 
无 效 的 结果 。 这 种 行为 的 原因 在 于 : 用 户 可 能 希望 点 击 Cancel 按钮 ， 而 无 需 订正 无 效 输 入 。 

5. 其 他 的 标准 格式 希 

除了 整数 格式 器 , JFormattedTextField AHA FAA hy ees. NumberFormat 
类 有 下 列 静态 方法 : 


getNumberInstance 
getCurrencyInstance 
getPercentInstance 
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它们 将 分 别 产 生 用 于 浮 点 数字 、 货 币值 和 百分比 的 格式 器 。 例 如 ， 通 过 下 面 的 调用 可 以 
获得 用 于 输入 货币 值 的 文本 框 。 | 

JFormattedTextField currencyField = new ]FormattedTextField(NumberFormat.getCurrencyInstance()) ; 

要 编辑 日 期 和 时 间 ， 可 以 调用 DateFormat 类 的 下 列 静 态 方法 之 一 : 


getDateInstance 
getTimeInstance 
getDateTimeInstance 


例如 : 

}FormattedTextField dateField = new JFormattedTextField(DateFormat.getDateInstance()) ; 
所 产生 的 文本 框 将 用 默认 格式 或 下 面 的 “中 等 长 度 ” 格 式 来 编辑 日 期 : 

Aug 5，2007 
也 可 以 选择 使 用 “ 短 ” 格 式 

8/5/07 
方法 是 调用 下 面 的 语句 : 

DateFormat.getDateInstance (DateFormat. SHORT) 
注意 . 默认 情况 下 ， 日 期 格式 器 是 很 “宽容 ”的 ， 也 就 是 说 , 2002 年 2 月 31 号 这 样 

的 无 效 日 期 将 会 滚动 到 下 二 个 有 效 日 期 2002 年 3 月 3 日。 这 种 行为 可 能 会 让 用 户 觉得 意 

外 ， 此 时 ， 可 以 在 DateFormat x} # EWA A setLenient(false), 

对 于 任何 类 ， 只 要 它 有 一 个 接受 字符 串 参 数 的 构造 器 ， 以 及 相 匹 配 的 toString 方法 ， 
那么 DefaultFormatter 就 可 以 格式 化 它 的 对 象 。 例 如 ，URL 类 有 一 个 URL(String) 构造 
器 ， 可 以 从 字符 串 中 构建 URL， 例 如 : 

URL url = new URL("http://horstmann.com") ; 


因此 ， 我 们 可 以 用 DefaultFormatter 格式 化 URL 对 象 。 格 式 器 会 在 文本 框 仁 上 调用 


参数 的 构造 器 来 构建 与 当前 值 属于 相同 类 的 新 对 象 。 如 果 这 个 构造 器 抛 出 了 异常 ， 那 么 这 次 
编辑 就 是 无 效 的 。 你 可 以 运行 示例 程序 ， 键 人 并非 以 “http: ”这 种 前 级 开头 的 URL, 然后 
观察 其 啊 应 。 
注意 . 默认 情况 下 ，Defau1tFormatter 是 履 写 模式 ， 这 与 其 他 格式 器 很 不 相同 ， 并 且 

不 是 非常 有 用 。 调 用 setOverwriteMode( false) 可 以 关闭 改写 模式 。 

最 后 ，MaskFormatter 对 于 包含 部 分 常量 和 部 分 变量 字符 的 固定 尺寸 的 模式 是 非常 有 
用 的 。 例 如 ， 社 会 保障 号 (例如 ，078-05-1120 ) 可 以 用 下 面 的 格式 器 进行 格式 化 : 

new MaskFormatter ("###-##-####" ) 

其 中 # 符号 表示 单个 数字 ， 表 10-3 ER TA VATE Sh a PT S 





558 Java ZSRR KI BAZ 


表 10-3 MaskFormatter 符号 


符号 fe R 符号 fe B 

# 一 个 数字 A 一 个 字母 或 数字 

? 一 个 字母 H 一 个 十 六 进 制 数字 [0-9A-Fa-f] 
U 一 个 字母 ， 转 换 为 大 写 任何 字符 

L 一 个 字母 ， 转 换 为 小 写 在 模式 中 包含 的 转 义 字符 


我 们 可 以 通过 调用 MaskFormatter 类 的 下 列 方法 之 一 来 限制 可 以 键入 到 文本 框 中 的 
字符 : 


setValidCharacters 
setInvalidCharacters 


例如 ， 要 读 入 用 字母 表示 的 成 绩 (例如 A+ 或 FE)， 可 以 执行 下 面 的 语句 ; 


MaskFormatter formatter = new MaskFormatter("U*") ， 
formatter. setValidCharacters("ABCDF+- "): 


但 是 ， 没 有 办 法 可 以 指定 第 二 个 字符 不 能 是 字母 。 

请 注意 ， 由 掩 码 格式 器 格式 化 的 字符 串 与 掩 码 有 严格 相同 的 长 度 。 如 果 用 户 在 编辑 
时 删除 了 某 些 字符 ， 那 么 它们 就 会 被 占 位 符 所 替换 。 默认 的 占 位 符 是 空格 ,但 是 可 以 用 
setPlaceholderCharacter 方法 来 改变 它 ， 例 如 : 


formatter, setPlaceholderCharacter('0'); 

默认 情况 下 ， 掩 码 格式 器 处 于 覆 写 模式 ， 这 很 直观 ， 所 以 运行 示例 程序 来 观察 它 。 同 时 
还 要 注意 脱 字符 的 位 置 会 跳 过 掩 码 中 的 固定 字符 。 

掩 码 格式 器 对 于 像 社会 保障 号 或 美国 电话 号 码 这 样 的 严格 模式 来 说 显得 非常 有 效 。 但 
是， 请 注意 ， 掩 码 模式 中 不 允许 有 任何 变 体 。 例 如 ， 不 能 将 掩 码 格式 器 用 于 国际 电话 号 码 ， 
因为 它们 的 位 数 并 不 固定 。 

6. 定制 格式 器 

如 采 所 有 的 标准 格式 器 都 不 适用 ， 那 么 我 们 可 以 很 方便 地 定义 自己 的 格式 器 。 请 考虑 4 
THY IP 地 址 ， 例 如 : 


130.65.86.66 

我 们 不 能 使 用 MaskFormatter， 因 为 每 个 字 节 都 可 以 由 1 个 、2 个 或 3 个 数字 表示 。 而 
且 ， 我 们 希望 格式 器 能 够 检查 每 个 字 节 的 值 最 大 不 能 超过 255。 

要 定义 自己 的 格式 器 ， 需 要 扩展 DefaultFormatter 类 ， 并 覆盖 下 面 的 方法 . 


String valueToString(Object value) 
Object stringToValue(String text) 


第 一 个 方法 将 文本 框 的 值 转换 为 显示 在 其 中 的 字符 串 ; 第 二 个 方法 解析 用 户 键入 的 文本 ， 
并 将 其 转换 回 对 象 。 这 两 个 方法 只 要 发 现 了 错误 ， 就 应 该 抛 出 ParseException。 
在 示例 程序 中 ， 我 们 用 长 度 为 4 的 byte[] 数组 存储 IP 地 址 。valueToString 方法 将 
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构建 由 这 些 字 节 构 成 的 字符 串 ， 其 中 字 节 与 字 节 之 间 由 句点 隔 开 。 注 意 ，byte 值 是 有 符号 
的 ， 取 值 范围 位 于 -128 与 127 之 间 (Ain, Æ IP 地 址 130.65.86.66 中 ， 第 一 个 八 位 实际 上 
是 表示 -126 的 字 节 )。 要 想 将 负 的 字 节 值 转换 为 无 符号 的 整数 值 ， 需 要 加 上 256。 


public String valueToString(Object value) throws ParseException 


if (!(value instanceof byte[])) 

throw new ParseException("Not a byte[]", 0); 
byte[] a = (byte[]) value; 
if (a.length != 4) 

throw new ParseException("Length != 4", 0); 
StringBuilder builder = new StringBuilder() ; 
for (int i = 0; i < 4; i++) 
{ 

int b = a[i]; 

if (b < 0) b += 256; 

builder.append(String.value0f(b)) ; 

if (i < 3) builder.append('.'); 


} 
return builder. toString() ; 
} 


反 过 来 ，stringToValue 方法 解析 这 个 字符 串 ， 并 且 在 该 字符 串 有 效 的 情况 下 产生 一 
个 byte[] 对 象 。 如 果 该 字符 串 无 效 ， 则 抛 出 ParseException。 


public Object stringToValue(String text) throws ParseException 
{ 


StringTokenizer tokenizer = new StringTokenizer(text, "."); 
byte[] a = new byte[4]; 


for (int i = 0; 1 < 4; i++) 


int b = 0; 
try 


b = Integer. parseInt (tokenizer. nextToken()) ; 


catch (NumberFormatException e) 


{ 


throw new ParseException("Not an integer", 0); 
} 
if (b< 0 || b >= 256) 
throw new ParseException("Byte out of range", 0); 
a[i] = (byte) b; 
} 


return a; 


} 

在 示例 程序 中 试验 一 下 IP 地 址 文本 框 ， 如 果 你 键入 了 无 效 的 地 址 ， 那 么 这 个 文本 框 就 会 
恢复 到 最 后 一 个 有 效 的 地 址 ， 完 整 的 格式 器 见 程序 清单 10-22。 

程序 清单 10-20 展示 了 各 种 格式 化 的 文本 框 (参见 图 10-37 )， 点 击 OK 按钮 可 以 从 这 些 
文本 框 中 获取 当前 的 值 。 





560 


Java SRR Al BRAK 


注意 : “Swing Connection ”在 线 通讯 有 一 篇 短文 描述 了 一 个 可 以 与 任何 正则 表达 式 匹 配 
的 格式 器 。 参 见 http://www.oracle.com/technetwork/java/reftf-138955.html。 


10 













package textFormat; 


import java.awt.*; 
import java.net.*: 
import java.text.*: 
import java.util.*; 


import javax.swing.*; 
import javax.swing.text.*; 


/** 
* A frame with a collection of formatted text fields and a button that displays the field values. 
3 
public class FormatTestFrame extends JFrame 
{ 
private DocumentFilter filter = new IntFilter(): 
private JButton okButton; 
private JPanel mainPanel : 


public FormatTestFrame() 

{ 
JPanel buttonPanel = new JPanel(); 
okButton = new JButton("Ok") 
buttonPanel .add(okButton) ; 
add(buttonPanel, BorderLayout. SOUTH) ， 


mainPanel = new JPanel (); 
mainPanel.setLayout(new GridLayout(0, 3)); 


add(mainPanel, BorderLayout.CENTER) : 


JFormattedTextField intField = new JFormattedTextFi eld (NumberFormat .getIntegerInstance()): 
intField.setValue(new Integer(100)); 
addRow("Number:", intField); 


JFormattedTextField intField2 = new JFormattedTextField(NumberFormat.getIntegerInstance()): 
intField2.setValue(new Integer(100)) : 
intField2.setFocusLostBehavior(JFormattedTextField. COMMIT) ; 
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addRow("Number (Commit behavior):", intField2) ; 


JFormattedTextField intField3 = new JFormattedTextField(new International Formatter( 
NumberFormat. getIntegerInstance()) 


protected DocumentFilter getDocumentFi ter () 
{ 
return filter; 


} 


}); 
intField3.setValue(new Integer(100)) ; 
addRow("Filtered Number", intField3) ; 


JFormattedTextField intField4 = new JFormattedTextField(NumberFormat.getIntegerInstance()) ; 
intField4.setValue(new Integer(100)) ; 
intField4.setInputVerifier(new InputVeri fier() 


public boolean verify(JComponent component) 


JFormattedTextField field = (JFormattedTextField) component; 
return field.isEditValid(Q) ; 
} 


}); 
addRow("Verified Number:", intField4) ; 


]FormattedTextField currencyField = new JFormattedTextField (NumberFormat 
-getCurrencyInstance()) ; 

currencyField.setValue(new Double(10)) ; 

addRow("Currency:", currencyField) ; 


}FormattedTextField dateField = new JFormattedTextField(DateFormat.getDateInstance()) ; 
dateField.setValue(new Date()); 
addRow("Date (default):", dateField) ; 


DateFormat format = DateFormat.getDateInstance(DateFormat. SHORT) ; 
format.setLenient (false) ; 

}FormattedTextField dateField2 = new JFormattedTextField(format) ; 
dateField2.setValue(new Date()) ; 

addRow("Date (short, not lenient):", dateField2); 


try 
{ 
DefaultFormatter formatter = new DefaultFormatter() ; 
formatter. setOverwri teMode (false) ; 
JFormattedTextField urlField = new JFormattedTextField(formatter) ; 
urlField.setValue(new URL("http://java.sun.com")) ; 
addRow("URL:", urlField); 


} 
catch (Mal formedURLException ex) 


ex.printStackTrace() ; 
} 


try 
{ 
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} 


MaskFormatter formatter = new MaskFormatter ("###-##-####"): 
formatter.setPlaceholderCharacter('0'); 

JFormattedTextField ssnField = new JFormattedTextField(formatter) ; 
ssnField, setValue("078-05-1120") ; 

addRow("SSN Mask:", ssnField); 


catch (ParseException ex) 


{ 


ex.printStackTrace() ; 


JFormattedTextField ipField = new JFormattedTextField(new IPAddressFormatter()): 
ipField.setValue(new byte[] { (byte) 130, 65, 86, 66 }): 

addRow("IP Address:", ipField); 

pack() ; 


/** 


* Adds a row to the main panel. 

* @param labelText the label of the field 
* @aram field the sample field 

党 


public void addRow(String labelText, final JFormattedTextField field) 


{ 


mainPanel.add(new JLabel (labelText)) ; 
mainPanel.add(field) ; 
final JLabel valueLabel = new JLabel(); 
mainPanel .add(valueLabel) ; 
okButton. addActionListener(event -> 
{ 
Object value = field. getValue(); 
Class<?> cl = value.getClass(); 
String text = null; 
if (cl.isArray()) 
{ 


if (cl.getComponentType() .isPrimitive()) 
{ 


try 
{ 
text = Arrays.class.getMethod("toString", cl).invoke(null, value) 
.toString(; 


catch (ReflectiveOperationException ex) 
// ignore reflection exceptions 


} 
else text = Arrays. toString((Object[]) value); 
} 
else text = value.toString(); 
valueLabel .setText(text) ; 
让 
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1 package textFormat; 

2 

3 import javax. swing. text.*; 

4 

5 /** 

6 * A filter that restricts input to digits and a '- 
7 */ 

s public class IntFilter extends DocumentFilter 

9 { 

10 public void insertString(FilterBypass fb, int offset, String string, AttributeSet attr) 
11 throws BadLocationException 


sign. 


13 StringBuilder builder = new StringBuilder(string) ; 
14 for (int i = builder.length() - 1; i >= 0; i--) 

15 { 

16 int cp = builder. codePointAt(i) ; 

17 if (!Character.isDigit(cp) & cp != '-') 

18 { 

19 builder.deleteCharAt (1) ; 

20 if (Character.isSupp]ementaryCodePoint (cp)) 
21 { 

22 1-7} 

23 builder.deleteCharAt (1) ; 

24 } 

25 } 

26 } 

27 super.insertString(fb, offset, builder.toString(), attr); 
28 } 


30 public void replace(FilterBypass fb, int offset, int length, String string, AttributeSet attr) 
31 throws BadLocationException 


32 { 

33 if (string != null) 

34 { 

35 StringBuilder builder = new StringBuilder(string) ; 
36 for (int i = builder.length() - 1; i >= 0; 1--) 
37 { 

38 int cp = builder. codePointAt(1) ; 

39 if (!Character.isDigit(cp) && cp != '-') 

40 { 

41 builder.deleteCharAt (1) ; 

42 if (Character.isSupp]ementaryCodePoint(cp)) 
43 { 

44 1--; 

45 builder.deleteCharAt(i); 

46 } 

47 } 

48 } 

49 string = builder. toString() ; 

50 } 

51 super.replace(fb, offset, length, string, attr); 
52 } 

;3 } 
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package textFormat; 


1 

2 

3 import java.text.*; 

4 import java.util.*: 

s import javax.swing.text.*; 
6 

7 

8 

9 


/** 

* A formatter for 4-byte IP addresses of the form a.b.c.d 

*/ 
10 public class IPAddressFormatter extends DefaultFormatter 
u { 
12 public String valueToString(Object value) throws ParseException 
13 { 
14 if (!(value instanceof byte[])) throw new ParseException("Not a byte[]", 0); 
15 byte[] a = (byte[]) value; 
16 if (a.length != 4) throw new ParseException("Length != 4", 0); 
17 StringBuilder builder = new StringBuilder(); 
18 for (int i = 0; i < 4; i++) 
19 { 
20 int b = afi]; 
21 if (b < 0) b += 256: 
22 builder. append (String. value0f(b)) ; 
23 if (i < 3) builder.append('.'); 
24 i 
25 return builder.toString(); 
26 } 


28 public Object stringToValue(String text) throws ParseException 


30 StringTokenizer tokenizer = new StringTokenizer(text, "."): 

31 byte(] a = new byte[4]; 

32 for (int 1 = 0; i < 4; i++) 

33 { 

34 int b = 0; 

35 if (!tokenizer.hasMoreTokens()) throw new ParseException("Too few bytes", 0); 
36 try 

37 { 

38 b = Integer. parseInt (tokenizer. nextToken()): 

39 

40 catch (NumberFormatException e) 

41 { 

42 throw new ParseException("Not an integer", 0); 

43 } 

44 if (b< 0 || b >= 256) throw new ParseException("Byte out of range", 0); 
45 a[i] = (byte) b; 

46 

47 if (tokenizer. hasMoreTokens()) throw new ParseException("Too many bytes", 0); 
48 return a; 

49 

so } 
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e JFormattedTextField(Format fmt) 
构建 使 用 指定 格式 的 文本 框 。 

ə JFormattedTextField(JFormattedTextField.AbstractFormatter formatter) 
构建 使 用 指定 格式 器 的 文本 框 。 注 意 , DefaultFormatter 和 InternationalFormatter 
都 是 JFormattedTextFie1d.AbstractFormatter 的 子 类 。 

è Object getValue() 
返回 文本 框 当前 的 有 效 值 。 注 意 ， 它 可 能 并 不 对 应 于 正在 编辑 的 字符 串 。 

e void setValue(Object value) 
尝试 设置 给 定 对 象 的 值 。 如 果 格 式 器 不 能 将 该 对 象 转换 为 字符 串 ， 则 尝试 失败 。 

e void commitEdit() 
尝试 从 编辑 的 字符 串 中 设置 文本 框 的 有 效 值 。 如 果 格 式 器 不 能 转换 该 字符 串 ， 则 该 符 
试 可 能 失败 。 

e boolean isEditValid() 

检查 编辑 的 字符 串 表 示 的 是 否 是 一 个 有 效 值 。 


e int getFocusLostBehavior( ) 


e void setFocusLostBehavior(int behavior) 


获取 或 设置 “失去 焦点 ”的 行为 。 表 示 该 行为 的 合法 值 是 JFormattedTextField 类 
的 常量 COMMIT_OR_REVERT、REVERT、COMMIT 和 PERSIST。 


eabstract String valueToString(Object value) 
将 值 转换 为 可 编辑 的 字符 串 。 如 果 值 并 不 适用 于 这 个 格式 器 ， 则 抛 出 ParseException。 


e abstract Object stringToValue(String s) 
将 字符 串 转换 为 值 。 如 果 s 格式 不 合适 ， 则 抛 出 ParseException, 
è DocumentFilter getDocumentFilter() 
覆盖 该 方法 以 提供 可 以 限制 该 文本 框 输入 的 文档 过 滤器 。nu11 返回 值 表示 不 需要 任何 
过 滤 机 制 。 


èe boolean getOverwriteMode( ) 


e void setOverwriteMode(boolean mode) 


获取 或 设置 覆 写 模式 。 如 果 确 实处 于 履 写 模式 ， 那 么 在 编辑 文本 时 ， 新 字符 会 覆 写 现 有 字符 。 


e void insertString(DocumentFilter.FilterBypass bypass, int offset, 
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String text, AttributeSet attrib) 
在 字符 串 插 人 到 文档 中 之 前 被 调用 。 可 以 覆盖 该 方法 并 修改 字符 串 。 可 以 禁止 插入 ， 
方法 是 不 要 调用 super.insertString 方法 ， 或 者 是 调用 bypass 方法 来 修改 没有 过 
滤 机 制 的 文档 。 
参数 : bypass ”这 是 一 个 允许 我 们 执行 绕 开 过 滤器 的 编辑 命令 的 对 象 

offset 插入 文本 处 的 偏 移 量 

text 待 插入 的 字符 

attrib ， 待 插入 文 本 的 格式 化 属性 
evoid replace(DocumentFilter.FilterBypass bypass, int offset, int length, 
String text, AttributeSet attrib) 
在 文档 的 部 分 内 容 被 替换 为 新 字符 串 之 前 被 调用 。 可 以 覆盖 该 方法 并 修改 字符 串 。 可 
以 禁止 蔡 换 ， 方 法 是 不 要 调用 super .rep1ace， 或 者 是 调用 bypass 方法 来 修改 没有 
过 滤 机 制 的 文档 。 
参数 : bypass ”这 是 一 个 允许 我 们 执行 绕 开 过 滤器 的 编辑 命令 的 对 象 

offset 插入 文 本 处 的 偏 移 量 

length 被 替 换 部 分 的 长 度 

text 待 插入 的 字符 

attrib — 竺 插入 文本 的 格式 化 属性 
evoid remove(DocumentFilter.FilterBypass bypass, int offset, int length) 
在 文本 的 部 分 内 容 被 删除 之 前 被 调用 。 如 果 需 要 分 析 移 除 的 效果 ， 可 以 通过 调用 
bypass.getDocument( ) 来 获取 该 文档 。 
参数 : bypass ”这 是 一 个 允许 我 们 执行 绕 开 过 滤器 的 编辑 命令 的 对 象 

offset FERRERI ns E 

length 符 移 除 部 分 的 长 度 





e MaskFormatter(String mask) 
用 给 定 的 掩 码 构建 掩 码 格式 器 。 人 参见 表 10-3 以 了 解 掩 码 中 的 符号 。 
e String getValidCharacters() 
èe void setValidCharacters(String characters) 
获取 或 设置 有 效 的 编辑 字符 。 对 于 掩 码 中 的 可 变 部 分 ， 只 有 位 于 给 定 字符 串 中 的 字符 
才 是 可 接受 的 。 
e String getInvalidCharacters() 
evoid setInvalidCharacters(String characters) 
获取 或 设置 无 效 的 编辑 字符 。 在 给 定 字 符 串 中 的 任何 字符 都 不 能 作为 输入 接受 。 


èe char getPlaceholderCharacter( ) 
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e void setPlaceholderCharacter(char ch) 
获取 或 设置 占 位 字符 ， 这 些 字符 用 作用 户 未 提供 的 掩 码 中 的 可 变 字符 。 默 认 的 占 位 符 
是 空格 。 

e String getP1aceholder( ) 

e void setPlaceholder(String s) 
MMS AEB. WRAP AS PES, DRA EA 
该 字符 串 的 末端 。 如 果 该 字符 串 为 null， 或 者 比 掩 码 短 ， 那 么 占 位 符 就 会 填充 剩余 的 
输入 。 

e boolean getValueContainsLiteralCharacters() 

e void setValueContainsLiteralCharacters(boolean b) 
获取 或 设置 “ 值 包含 字面 常量 字符 ”标志 。 如 果 该 标志 为 true， 那 么 该 文本 框 的 值 就 
包含 掩 码 中 的 字面 常量 (不 可 变 ) 部 分 。 如 果 该 标志 为 false， 那 么 字面 常量 字符 将 被 
移 除 。 其 默认 值 为 true。 


10.4.3 JSpinner 构件 


JSpinner Ef — 4 LAE BITTE AREF pe | 
边 的 小 按钮 的 构件 。 当 点 击 按钮 时 ， 文 本 框 的 值 就 会 Eb oe am en 
递增 或 递减 (参见 图 10-38 )。 a Pe 

微调 器 中 的 值 可 以 是 数字 、 日 期 、 列 表 中 的 值 ， 
或 者 是 更 为 普遍 的 情况 ， 即 前 驱 和 后 继 可 以 确定 的 任 
何 值 序列 。 JSpinner 类 为 前 三 种 情况 定义 了 标准 的 RL AUST 7 ah 
ao 我 们 可 以 定义 自己 的 数据 模型 来 描述 任意 e 1038 a i 

默认 情况 下 ， 微 调 器 管理 着 一 个 整数 ， 并 且 两 个 按钮 将 对 其 按照 1 进行 递增 和 递减 。 可 
以 通过 调用 getValue 方法 来 获取 当前 值 ， 这 个 方法 将 返回 一 个 0bject， 应 该 将 其 转型 为 
Integer 并 获取 其 中 包装 的 值 。 


JSpinner defaultSpinner = new Jo9pinner() ; 





int value = (Integer) defaultSpinner.getValue() ; 


我 们 可 以 将 递增 的 值 修改 为 1 SOPRA, ET PAGE EI A LAAT PA PR ed at 
的 初始 值 为 5， 边 界 为 0 到 10， 每 次 递增 0.5: 


JSpinner boundedSpinner = new JSpinner(new SpinnerNumberModel (5, 0, 10, 0.5)); 


SpinnerNumberModel 有 两 个 构造 器 ， 其 中 一 个 只 有 int 参数 ， 而 男 一 个 有 double 参 
数 。 只 要 有 参数 是 浮 点 数 ， 就 会 使 用 第 二 个 构造 器 ， 它 会 将 微调 器 的 值 设 置 为 Double 对 象 。 

微调 器 并 未 限制 为 只 能 是 数字 型 值 ， 我 们 可 以 用 微调 器 迭代 任何 值 集合 ， 只 需 将 一 个 
SpinnerListModel 传递 给 JSpinner 构造 器 即 可 。 我 们 可 以 从 数组 或 实现 了 List 接口 的 
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类 《例如 ArrayList) 中 构建 SpinnerListMode1。 在 示例 程序 中 ， 我们 显示 了 一 个 微调 控 
制 问 ， 它 的 值 是 所 有 可 用 的 字体 名。 


String[] fonts = GraphicsEnvironment.getLocalGraphicsEnvironment() .getAvailableFontFamilyNames(): 
JSpinner listSpinner = new JSpinner(new SpinnerListModel (fonts)) ; 


但 是 ,我 们 发 现 迭 代 的 方向 略 有 些 令 人 疑惑 ， 因 为 它 与 用 户 关 于 组 合 框 的 体验 相关 。 在 
组 合 框 中 ， 较 高 的 值 在 较 低 的 值 的 下 面 ， 因 此 ， 我 们 用 向 下 箭头 来 导航 到 较 高 的 值 。 但 是 微 
调 希 将 递增 数组 索引 ， 使 得 向 上 箭头 可 以 产生 较 高 的 值 。 在 SpinnerListMode1 中 没有 用 
于 厦 倒 遍历 顺序 的 方法 ,但 是 临时 创建 一 个 匿名 子 类 就 可 以 产生 想 要 的 结果 : 
JSpinner reverseListSpinner = new JSpinner( 
new SpinnerListModel (fonts) 


public Object getNextValue() 
{ 


return super.getPreviousValue() ; 


public Object getPreviousValue() 
{ 
return super. getNextValue() ; 
D; 
试 运行 这 两 个 版 本 ， 看 看 哪 一 个 更 直观 些 。 
微调 器 的 为 一 个 大 显 映 手 之 处 是 可 以 让 用 户 递 增 或 递减 的 日 期 。 用 下 面 的 调用 就 可 以 获 
得 这 样 的 微调 器 ， 并 用 当日 的 时 间 进 行 初始 化 。 
JSpinner dateSpinner = new JSpinner(new SpinnerDateModel ()); 


但 是 ， 如 果 你 仔细 查看 图 10-38， 就 会 发 现 微调 器 文本 同时 显示 了 日 期 和 时 间 ， 例 如 

8/05/07 9:05 PM 

WT) REP H a PR aR A EM, TLE a ab as H BE ERE, i 
就 是 这 样 的 “ 魔 光 ”: 

JSpinner betterDateSpinner = new JSpinner(new SpinnerDateModel ()); 


String pattern = ((SimpleDateFormat) DateFormat.getDateInstance()).toPattern() ; 
betterDateSpinner.setEditor(new JSpinner.DateEditor(betterDateSpinner, pattern)); 


使 用 相同 的 方法 ， 还 可 以 创建 一 个 时 间 选 择 器 


JSpinner timeSpinner = new JSpinner(new SpinnerDateModel ()) ; 
pattern = ((SimpleDateFormat) DateFormat. getTimeInstance(DateFormat.SHORT)).toPattern(); 
timeSpinner.setEditor(new JSpinner.DateEditor(timeSpinner, pattern)); 


通过 定义 目 己 的 微调 器 模型 ， 你 可 以 在 微调 器 中 显示 任意 的 序列 。 在 示例 程序 中 ， 我 
们 用 一 个 微调 融 迭 代 了 字符 串 “ meat” 的 所 有 排列 。 你 可 以 通过 点 击 微 调 器 按钮 来 获取 
“mate”、“meta”、“team ”以 及 其 他 20 种 排列 。 

在 定义 目 己 的 模型 时 ， 需 要 扩展 AbstractSpinnerMode1 类 并 定义 下 面 的 4 个 方法 : 
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Object getValue() 

void setValue(Object value) 
Object getNextValue() 
Object getPreviousValue() 


get Value 方法 将 返回 模型 存储 的 值 ， 而 setValue 方法 则 把 这 个 值 设 置 为 新 值 ， 如 果 
新 值 并 不 适合 用 于 设置 ， 则 该 方法 会 抛 出 I111ega1ArgumentException。 


Q 警告 : setValue 方法 必须 在 设置 新 值 之 后 调用 fireStateChanged 方法 ， 否 则 ， 微 调 
器 文本 框 并 不 会 更 新 。 
getNextValue 和 getPreviousValue 方法 将 分 别 位 于 返回 当前 值 之 后 和 之 前 的 值 ， 
或 者 在 到 达 遍 历 的 终点 时 返回 null, 
a 警告 : getNextValue 和 getPreviousValue 方法 不 应 该 改变 当前 值 。 当 用 户 点 击 微调 
器 的 向 上 箭头 时 ，getNextValue 方法 就 会 被 调用 。 如 果 其 返回 值 不 是 nu11， 微 调 器 的 
值 会 通过 一 个 对 setValue 的 调用 进行 设置 。 
在 示例 程序 中 ， 我 们 使 用 了 标准 的 算法 来 确定 下 一 个 和 前 一 个 排列 ， 而 这 个 算法 的 细节 


并 不 重要 ( 见 程序 清单 10-24 ) 。 
程序 清单 10-23 展示 了 如 何 生成 各 种 不 同 的 微调 器 类 型 ， 请 点 击 Ok 按钮 以 观察 微调 箱 


的 值 。 





package spinner; 


1 

2 

3 import java.awt.*; 

4 import java.awt.event.*; 
5 import java.text.*; 

6 import javax.swing.*; 

7 

8 

9 


/** 
* A frame with a panel that contains several spinners and a button that displays the spinner 

10 * values. 
u */ 
12 public class SpinnerFrame extends JFrame 
3 { 
14 private JPanel mainPanel ; 
15 private JButton okButton; 


17 public SpinnerFrame() 


18 { 

19 JPanel buttonPanel = new JPanel(); 

20 okButton = new JButton("0k"); 

21 buttonPanel .add(okButton) ; 

22 add(buttonPanel, BorderLayout. SOUTH) ; 
23 

24 mainPanel = new JPanel(); 


25 mainPanel,setLayout(new GridLayout(0, 3)); 
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} 


add(mainPanel, BorderLayout.CENTER) ; 


JSpinner defaultSpinner = new JSpinner(); 
addRow("Default", defaultSpinner); 


JSpinner boundedSpinner = new JSpinner(new SpinnerNumberModel (5, 0, 10, 0.5)); 
addRow("Bounded", boundedSpinner) ; 


String[] fonts = GraphicsEnvironment.getLocalGraphicsEnvi ronment () 
.getAvailableFontFami ]yNames () ; 


JSpinner listSpinner = new JSpinner(new SpinnerListModel (fonts)) : 
addRow("List", listSpinner); 


JSpinner reverseListSpinner = new JSpinner(new SpinnerListModel (fonts) 


public Object getNextValue() { return super.getPreviousValue(); } 
public Object getPreviousValue() { return super.getNextValue(); } 


addRow( Reverse List", reverseListSpinner) ; 


JSpinner dateSpinner = new JSpinner(new SpinnerDateModel ()); 
addRow("Date", dateSpinner) ; 


JSpinner betterDateSpinner = new JSpinner(new SpinnerDateModel ()) ; 

String pattern = ((SimpleDateFormat) DateFormat.getDateInstance()).toPattern(): 
betterDateSpinner.setEditor(new JSpinner.DateEditor(betterDateSpinner, pattern)); 
addRow("Better Date", betterDateSpinner) ; 


]Spinner timeSpinner = new JSpinner(new SpinnerDateModel ()): 

pattern = ((SimpleDateFormat) DateFormat.getTimeInstance(DateFormat.SHORT)).toPattern(); 
timeSpinner.setEditor(new JSpinner.DateEditor(timeSpinner, pattern)); 

addRow("Time", timeSpinner) ; 


JSpinner permSpinner = new JSpinner(new PermutationSpinnerModel ("meat")) ; 
addRow("Word permutations", permSpinner) ; 
pack() ; 


* Adds a row to the main panel. 
* @param labelText the label of the spinner 
* @param spinner the sample spinner 


public void addRow(String labelText, final JSpinner spinner) 


mainPanel .add (new JLabel (labelText)) ; 
mainPanel .add (spinner) ; 
final JLabel valueLabel = new JLabel(); 
mainPanel.add(valueLabel) ; 
okButton.addActionListener(event -> 
{ 
Object value = spinner.getValue() ; 
valueLabel .setText(value.toString()); 
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1 package spinner; 
2 
3 import javax.swing.*; 


4 

5 ak 

6 * A model that dynamically generates word permutations. 

7 */ 

s public class PermutationSpinnerModel extends AbstractSpinnerModel 
9 


{ 


10 private String word; 


1? /** 


13 * Constructs the model. 
14 * @param w the word to permute 


15 gi 

16 public PermutationSpinnerModel (String w) 
17 { 

18 word = w; 

19 } 


n public Object getValueQ) 
{ 


23 return word; 

4 } 

25 

25 public void setValue(Object value) 

27 

28 if (!(value instanceof String)) throw new I]]legalArgumentException () ; 
29 word = (String) value; 

30 fireStateChanged() ; 

31 } 

32 

3 public Object getNextValue() 

34 { 

35 int[] codePoints = toCodePointArray (word) ; 

36 for (int i = codePoints. length - 1; 1 > 0; 1--) 

37 { 

38 if (codePoints[i - 1] < codePoints[i]) 

39 { 

40 int j = codePoints.length - 1; 

41 while (codePoints[i - 1] > codePoints[j]) 

42 J= 

43 swap(codePoints, i - 1, j); 

44 reverse(codePoints, i, codePoints. length - 1); 
45 return new String(codePoints, 0, codePoints. length) ; 
46 } 
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reverse(codePoints, 0, codePoints. length - 1); 
return new String(codePoints, 0, codePoints. length) ; 


} 
public Object getPreviousValue() 
{ 


int[] codePoints = toCodePointArray (word): 
for (int i = codePoints. length - 1; i > 0; i--) 


if (codePoints[i - 1] > codePoints[i]) 
{ 


int j = codePoints. length - 1; 
while (codePoints[i - 1] < codePoints[j]) 
Pa 
swap(codePoints, i - 1, j); 
reverse(codePoints, i, codePoints.length - 1); 
return new String(codePoints, 0, codePoints. length); 
} 
} 


reverse(codePoints, 0, codePoints. length - 1); 
return new String(codePoints, 0, codePoints. length); 


} 
private static int[] toCodePointArray(String str) 


int[ codePoints = new int[str.codePointCount(0, str.length())]; 
for (int i = 0, j = 0; i < str. Jength(); i++, j++) 
{ 
int cp = str.codePointAt(i); 
if (Character.isSupp]lementaryCodePoint(cp)) i++: 
codePoints[j] = cp; 


return codePoints; 


} 


private static void swap(int[] a, int i, int j) 
{ 

int temp = afi]; 

ali] = a[j]; 

a[j] = temp; 


private static void reverse(int[] a, int i, int j) 
while (i < j) 
{ 
swap(a, i, j); 


i+; 
laa 
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e JSpinner() 
构建 一 个 微调 器 ， 它 可 以 编辑 从 0 开始 、 每 次 递增 1， 并 且 没 有 边界 的 整数 值 。 
e JSpinner(SpinnerModel model) 
构建 一 个 微调 器 ， 它 将 使 用 给 定 的 数据 模型 。 
è Object getValue() 
获取 微调 器 的 当前 值 。 
evoid setValue(Object value) 
尝试 着 设置 微调 器 的 值 ， 如 果 模 型 不 接受 这 个 值 ， 将 抛 出 I11egalArgumentException。 


e void setEditor(JComponent editor) 


设置 用 于 编辑 微调 器 值 的 构件 。 








è SpinnerNumberModel(int initval, int minimum, int maximum, int stepSize) 
e SpinnerNumberModel(double initval, double minimum, double maximum, 
double stepSize) 
这 些 构造 器 将 产生 一 个 管理 Integer 或 Double 类 型 值 的 数字 模型 。 可 以 用 Integer 
或 Double 类 的 MIN_VALUE 和 MAX_VALUE 常量 来 表示 不 受 边界 限制 的 值 。 
参数 : initval {AASB 
minimum 最 小 值 
maximum 最 大 值 
stepSize ， 每 次 微调 的 递增 或 递减 量 





èe SpinnerListModel(Object[] values) 
e SpinnerListModel(List values) 
这 些 构造 器 将 产生 从 给 定 的 值 中 选择 一 个 值 的 模型 。 





e SpinnerDateModel() 
用 当日 的 日 期 作为 初始 值 构建 一 个 日 期 模型 ， 在 该 模型 中 没有 上 界 和 下 界 ， 其 递增 量 
为 Calendar .DAY_OF_MONTH, 

e SpinnerDateModel(Date initval, Comparable minimum, Comparable 


maximum, int step) 
HM: initval 初始 值 
minimum ”最 小 值 ， 在 不 希望 有 下 界 时 为 nu11 
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maximum 最 大 值 ， 在 不 希望 有 上 界 时 为 nu11 

step 每 次 微调 递增 或 递减 的 日 期 ， 它 的 值 是 Calendar 类 的 常量 ERA、 
YEAR, MONTH, WEEK_OF_YEAR, WEEK_OF_MONTH, DAY_OF_MONTH, 
DAY_OF_YEAR, DAY_OF_WEEK, DAY_OF_WEEK_IN_MONTH, AM_PM, 
HOUR, HOUR_OF_DAY, MINUTE, SECOND sk MILLISECOND 之 一 





è String toPattern() 1.2 
获取 用 于 这 个 日 期 格式 器 的 编辑 模式 。 典 型 的 模式 为 “yyyy-MM-dd”， 参 见 Java SE 
文档 以 了 解 关 于 该 模式 的 详细 信息 。 








e DateEditor(JSpinner spinner, String pattern) 
构建 一 个 用 于 微调 器 的 日 期 编辑 器 。 
参数 : spinner 该 编辑 器 所 属 的 微调 器 

pattern 用 于 相关 联 的 Simp1eDateFormat 的 格式 化 模式 





e Object getValue() 
获取 该 模型 的 当前 值 。 

evoid setValue(Object value) 
ZARKENT AE. WRI MAA I ES, WH 11 1egalArgument 
Exception。 当 覆盖 该 方法 时 ， 应 该 在 设置 新 值 之 后 调用 fireStateChanged, 

e Object getNextValue() 

e Object getPreviousValue( ) 

计算 (但 不 是 设置 ) 该 模型 所 定义 的 序列 中 的 下 一 个 和 前 一 个 值 。 


10.4.4 用 JEditorPane 显示 HTML 


与 之 前 我 们 讨论 的 文本 构件 不 同 ，JEditorPane 能 够 以 HTML Ail RTF 的 格式 显示 和 编 
辑 文本 。( RTF 即 “ 富 文本 格式 ”， 是 许多 微软 应 用 进行 文档 交换 的 格式 。 它 是 一 种 弱 文 档 格 
式 ， 即 使 在 微软 自己 的 应 用 之 间 也 无 法 很 好 地 运行 。 在 本 书 中 我 们 将 不 介绍 RTF 的 应 用 。) 

坦 日 地 说 ，JEditorPane 的 功能 还 不 尽 如 人 意 。HTML 绘制 器 只 能 显示 简单 的 文件 ， 
但 是 对 于 在 Web 上 经 常 出 现 的 复杂 页 面 ， 它 往往 难于 处 理 。HTML 编辑 器 不 仅 功 能 有 限 ， 而 
且 还 不 稳定 。 

JEditorPane 看 似 合理 的 一 种 应 用 就 是 以 HTML 的 形式 显示 程序 的 帮助 文档 。 因 为 你 
可 以 控制 你 提供 的 帮助 文件 ， 所 以 可 以 避 开 JEditorPane 不 能 很 好 显示 的 特性 。 
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注意 : 如 果 想 获得 有 关 业 界 强度 的 帮助 系统 的 更 多 信息 ， 请 到 网 站 http://javahelp.java.net 
上 查看 JavaHelp。 


程序 清单 10-25 中 的 程序 代码 包含 一 个 编辑 器 面板 ， 用 于 显示 HTML 页 面 的 内 容 。 在 


文本 框 中 键入 一 个 URL， 该 URL 必须 以 http: 或 fle: 开 头 ， 接 着 点 击 Load 按钮 ， 选 定 的 
HTML 页 面 就 会 显示 到 编辑 器 面板 中 (参见 图 10-39 )。 


In Part 3 of his SOA series Eric Giguere explores how to do SOA 
when the target device does not support Web Services (JSR 172). 


Programmers 

JavaFX Script is a highly productive scripting language that enables content 
developers to create rich media and content e hor deployment on Java environments. 
This article, aimed at traditional Java developers, is a brief but thorough 
introđuction to Sun's exciting new technology. 





图 10-39 显示 一 个 HTML 页 面 的 编辑 器 面板 

该 超 链接 是 活动 的 : 如 果 你 点 击 一 个 链接 ， 该 应 用 程序 就 将 其 载 人 。Back 按钮 可 以 返回 
前 一 页 面 。 

这 个 程序 实际 上 是 一 个 非常 简单 的 浏览 器 。 当 然 ， 它 并 不 具有 你 期 望 从 商业 浏览 帮 可 获 
得 的 任何 舒适 特性 ， 例 如 页 面 缓 冲 或 者 书签 列表 等 。 该 编辑 器 面板 甚至 不 能 显示 Applet. 

如 果 你 点 击 Editable 复 选 框 ， 那 么 编辑 器 面板 就 会 成 为 可 编辑 的 。 你 可 以 键入 文本 ， 
并 且 可 以 使 用 BACKSPACE 键 删 除 文本 。 该 构件 还 能 够 理解 用 于 剪 切 、 复 制 以 及 粘贴 的 
CTRL+X, CTRL+C 以 及 CTRL+V 快捷 键 。 不 过 ， 还 必须 进行 一 些 编程 来 添加 对 字体 和 格式 
的 文 持 。 

当 该 构件 变 成 可 编辑 的 之 后 ， 超 链接 就 不 是 活动 的 了 。 另 外 ， 对 于 一 些 Web 页 面 ， 在 
启动 编辑 模式 的 时 候 (参见 图 10-40 )， 你 可 以 看 到 JavaScript 命令 、 注 释 以 及 其 他 一 些 标签 。 
这 个 示例 程序 可 以 让 你 查看 到 编辑 的 特性 ， 但 是 我 们 建议 在 程序 中 忽略 这 些 特性 。 

G 提示 : 在 默认 情况 下 ,JEditorPane 是 处 于 编辑 模式 的 。 可 以 调用 editorPane. 
setEditable (false) 将 其 关闭 。 

在 该 示例 程序 中 所 看 到 的 编辑 器 面板 的 一 些 特性 是 很 容易 使 用 的 ， 可 以 使 用 setPage 方 
法 载 人 一 个 新 文档 。 例 如 ， 


JEditorPane editorPane = new JEditorPane(); 
editorPane. setPage(url); 
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图 10-40 “处 于 编辑 模式 的 编辑 器 面板 


其 参数 要 么 是 一 个 字符 串 ， 要 么 是 一 个 URL 对 象 。JEditorPane 类 继承 了 JTextComponent 
类 。 因 此 ， 也 可 以 调用 只 能 显示 纯 文 本 的 setText 方法 。 


@ 提示 : 关于 setPage 是 否 是 在 一 个 单独 的 线程 中 载 入 一 个 新 的 文档 ， 它 的 API 文档 写 得 
也 不 是 很 清楚 〈 这 个 特性 通常 正 是 你 想 要 的 ， 而 JEditorPane 工作 效率 并 不 高 )。 不 过 ， 
可 以 使 用 下 面 几 条 语句 强制 在 一 个 单独 线程 中 载 入 : 


AbstractDocument doc = (AbstractDocument) editorPane.getDocument() ; 
doc. setAsynchronousLoadPriority(0) ; 


为 了 监听 超 链 接 的 点 击 事件 ， 需 要 添加 一 个 HyperlinkListener, HyperlinkListener 
接口 只 有 一 个 单一 方法 hyper1inkUpdate， 当 用 户 移 到 或 点 击 一 个 超 链 接 的 时 候 ， 该 方法 就 
会 被 调用 。 该 方法 接收 一 个 类 型 为 Hyper1inkEvent 的 数据 作为 参数 。 

需要 调用 getEventType 方 法 以 确定 发 生 了 什么 类 型 的 事件 。 下 面 是 三 种 可 能 的 返 
回 值 : 


HyperlinkEvent, EventType. ACTIVATED 
HyperlinkEvent. EventType. ENTERED 
HyperlinkEvent. EventType. EXITED 


第 一 个 值 表 明 用 户 点 击 了 该 超 链接 。 在 这 种 情况 下 ， 通 常 希望 打开 一 个 新 的 链接 ， 可 以 
使 用 第 二 个 值 和 第 三 个 值 提供 可 视 化 的 反馈 信息 ， 例 如 ， 当 鼠标 停留 在 一 个 链接 上 面 ， 提 供 
一 个 工具 提示 。 


$B: 至 于 为 什么 在 Hyper1inkListener 接口 里 面 不 用 3 个 独立 的 方法 来 处 理 启动 、 
进入 和 退出 ， 完 全 是 一 件 神秘 的 事情 。 


Hyper1inkEvent 类 的 getURL 方法 返回 超 链 接 的 URL。 例 如 ， 下 面 展 示 了 怎样 安装 一 
个 超 链接 监听 器 追踪 用 户 激活 的 链接 ; 


editorPane.addHyperlinkListener(event -> 
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{ 
if (event.getEventType() == HyperlinkEvent. EventType. ACTIVATED) 


{ 
try 


{ 
editorPane. setPage(event.getURL()) ; 


catch (IOException e) 


editorPane.setText("Exception: " + e); 


} 
} 
}); 


事件 处 理 器 直接 获得 URL， 并 更 新 编辑 器 面板 。setPage 方 法 可 以 抛 出 一 个 
IOException 异常 ， 在 这 种 情况 下 ， 我 们 将 一 条 错误 消息 作为 纯 文本 进行 显示 。 

程序 清单 10-25 展示 了 构建 一 个 HTML 帮助 系统 所 需 的 全 部 特性 。 从 本 质 上 讲 ， 
JEditorPane 比 树 和 表格 构件 都 要 复杂 。 不 过 ， 如 果 不 需要 编写 定制 文本 格式 的 文本 编辑 
器 或 者 绘制 器 ， 这 些 复 杂 性 就 会 自动 对 你 隐藏 起 来 了 。 








package editorPane; 


import java.awt.*; 

import java.awt.event.*; 
import java.10.*; 

import java.util.*; 

import javax.swing.*; 
import javax.swing.event.*; 


bO oo N an ua A we N e 


/[** 

u * This frame contains an editor pane, a text field and button to enter a URL and load a document, 
1 * and a Back button to return to a previously loaded document. 

3 j 

14 public class EditorPaneFrame extends JFrame 

15 { 

15 private static final int DEFAULT_WIDTH = 600; 

17 private static final int DEFAULT_HEIGHT = 400; 


= 
O 


19 public EditorPaneFrame() 


{ 
21 setSize(DEFAULT_WIDTH, DEFAULT_HEIGHT) ; 


23 final Stack<String> urlStack = new Stack<>(); 

24 final JEditorPane editorPane = new JEditorPane(); 
25 final JTextField url = new JTextField(30); 

26 

27 // set up hyperlink listener 

28 

29 editorPane.setEditable(false) ; 


30 editorPane.addHyperlinkListener(event -> 
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{ 
if (event.getEventType() == HyperlinkEvent. EventType. ACTIVATED) 
{ 
try 
{ 
// remember URL for back button 
urlStack.push(event.getURL().toString()); 
// show URL in text field 
url .setText (event. getURL().toString()); 
editorPane. setPage(event.getURL()) ; 


} 
catch (IOException e) 
{ 


} 
} 
D; 


editorPane.setText("Exception: ”+ e); 


// set up checkbox for toggling edit mode 


final JCheckBox editable = new JCheckBox(); 
editable. addActionListener(event -> 
editorPane.setEditable(editable.isSelected())); 


// set up load button for loading URL 


ActionListener listener = event -> 


{ 
try 


// remember URL for back button 
urlStack.push(url .getText()); 
edi torPane.setPage(url.getText()); 


} 
catch (IOException e) 
{ 
editorPane.setText("Exception: " + e); 
} 
iH 


JButton loadButton = new JButton("Load"): 
loadButton.addActionListener (listener); 
url.addActionListener(listener) ; 


// set up back button and button action 


JButton backButton = new JButton("Back"); 
backButton.addActionListener(event -> 


if (urlStack.size() <= 1) return; 
try 
{ 
// get URL from back button 
urlStack.pop() ; 
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85 // show URL in text field 

86 String urlString = urlStack.peek() ; 

87 url. setText(url String) ; 

88 editorPane. setPage (url String) ; 

89 

90 catch (IOException e) 

91 { 

92 editorPane.setText("Exception: " + e); 
93 } 

94 }); 

95 

96 add(new JScrol]Pane(editorPane), BorderLayout.CENTER) ; 
97 

98 // put all control components in a panel 

99 

100 JPanel panel = new JPanel (); 


101 panel.add(new JLabel ("URL")); 

102 panel .add(url); 

103 panel .add(loadButton) ; 

104 panel .add(backButton) ; 

105 panel.add(new JLabel ("Editable")) ; 
106 panel .add(edi table); 


108 add(panel, BorderLayout. SOUTH) ; 





e void setPage(URL url) 


将 来 自 于 ur1 的 页 面 导 入 到 编辑 器 面板 中 。 
e void addHyperlinkListener(HyperLinkListener listener ) 


Fy Shei BE it TEL A ASD — Fe BB YT o 





e void hyperlinkUpdate(HyperlinkEvent event) 
无 论 何 时 ， 只 要 选 定 了 一 个 超 链接 ， 该 方法 就 会 被 调用 。 





e URL getURL( ) 
返回 所 选 超 链接 的 URL。 


10.5 “进度 指示 器 


在 随后 的 几 节 中 ， 我 们 将 讨论 三 个 类 ， 用 于 指示 耗 时 较 长 活动 的 进度 。JProgressBar 
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是 一 个 用 于 指示 进度 的 Swing 构件 ; ProgressMonitor 是 一 个 包含 进度 条 的 对 话 框 ; 在 读 
取 流 的 时 候 ，ProgressMonitorInputStream 用 于 显示 进度 监视 器 对 话 框 。 


10.5.1 进度 条 


进度 条 只 不 过 是 一 个 矩形 构件 ， 它 被 部 分 地 填充 了 
颜色 以 指示 一 个 操作 的 进度 。 默 认 情 况 下 ， 进 度 是 用 字 
符 串 “n% ”来 指示 的 。 在 图 10-41 右 下 方 ， 你 可 以 看 到 
一 个 进度 条 。 

通过 提供 最 大 值 和 最 小 值 以 及 一 个 可 供 选 择 的 定位 
方向 ， 就 可 以 像 构建 一 个 滑动 条 那样 构建 一 个 进度 条 : 


progressBar = new JProgressBar(0, 1000); 
progressBar = new JProgressBar(SwingConstants.VERTICAL, 0, 1000); 


也 可 以 使 用 setMinimum 和 setMaximum 方法 来 设置 最 大 值 和 最 小 值 。 

和 滑动 条 不 同 的 是 ， 进 度 条 不 能 让 用 户 自行 调节 。 你 的 程序 必须 调用 set Value 才能 对 
它 进 行 更 新 。 

如 果 调 用 

progressBar. setStringPainted(true) ; 


那么 进度 条 会 计算 出 某 项 操作 完成 的 百分比 ， 然 后 以 一 个 “n% ”形式 的 字符 串 将 它 显 示 出 
来 。 如 采 你 想 以 不 同形 式 的 字符 串 将 它 显 示 出 来 ， 可 以 用 setString 方法 提供 该 字符 串 : 


if (progressBar.getValue() > 900) 
progressBar.setString("“Almost Done"); 


程序 清单 10-26 展示 了 一 个 进度 条 ， 用 于 监视 一 个 耗 时 的 模拟 活动 。 

SimulatedActivity 类 将 值 current 每 秒 钟 增加 10 倍 。 每 当 它 达到 目标 值 的 时 候 ， 
该 任务 就 结束 。 我 们 使 用 SwingWorker 类 实现 了 这 项 任务 并 在 process 方法 中 更 新 了 进度 
条 ， 而 SwingWorker 是 在 事件 分 发 线程 中 调用 方法 的 ， 这 样 它 就 可 以 安全 地 更 新 进度 条 了 。 
(AX Swing 中 线程 安全 的 更 多 信息 请 参见 卷 1 第 14 章 。) 

Java SE 1.4 增加 了 对 不 确定 进度 条 的 支持 ， 这 种 进度 条 能 够 以 动画 显示 某 种 类 型 的 进度 ， 
而 不 具体 显示 完成 情况 的 百分比 。 可 以 在 你 的 浏览 器 中 看 到 这 种 类 型 的 进度 条 ， 它 指示 浏览 
需 正 在 等 待 服务 器 ， 但 是 无 法 知道 到 底 可 能 要 等 竺 多久。 如 果 要 以 动画 显示 “不 确定 等 待 ”， 
请 调用 setIndeterminate 方法 。 
程序 清单 10-26 显示 了 这 个 程序 的 完整 代码 。 





图 10-41 进度 条 





1 package progressBar; 


2 
3 Import java.awt.*; 
4 import java.util.List; 


“ 
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6 import javax.swing.*; 


/ 


ek 


* A frame that contains a button to launch a simulated activity, a progress bar, and a text area 
* for the activity output. 


*/ 


public class ProgressBarFrame extends JFrame 


{ 


public static final int TEXT_ROWS = 10; 
public static final int TEXT_COLUMNS = 40; 


private JButton startButton; 
private )ProgressBar progressBar; 
private JCheckBox checkBox; 

private JTextArea textArea; 

private SimulatedActivity activity; 


public ProgressBarFrame() 


{ 


} 


// this text area holds the activity output 
textArea = new JTextArea(TEXT_ROWS, TEXT_COLUMNS) ; 


// set up panel with button and progress bar 


final int MAX = 1000; 

JPanel panel = new JPanel (); 
startButton = new JButton("Start"); 
progressBar = new JProgressBar(0, MAX); 
progressBar. setStringPainted(true) ; 
panel .add(startButton) ; 

panel .add(progressBar) ; 


checkBox = new JCheckBox("indetermi nate") ; 
checkBox.addActionListener(event -> 
{ 
progressBar. setIndeterminate(checkBox.isSelected()) ; 
progressBar.setStringPainted(!progressBar.isIndeterminate()) ; 


}); 
panel .add(checkBox) ; 
add(new JScrol]Pane(textArea), BorderLayout.CENTER) ; 
add(panel, BorderLayout. SOUTH) ; 


// set up the button action 


startButton.addActionListener(event -> 
{ 
startButton. setEnabled(false) ; 
activity = new SimulatedActivity (MAX) ; 
activity.execute() ; 
}); 
pack() ; 


class SimulatedActivity extends SwingWorker<Void, Integer> 
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60 { 

61 private int current; 

62 private int target; 

63 

64 /** 

65 * Constructs the simulated activity that increments a counter from 0 to a 
66 * given target. 

67 * @aram t the target value of the counter 
68 */ 

69 public SimulatedActivity(int t) 

70 { 

71 current = 0; 

n target = t; 

73 } 

74 

75 protected Void doInBackground() throws Exception 
16 { 

77 try 

78 { 

79 while (current < target) 

80 { 

81 Thread.sleep(100) ; 

82 current++; 

83 publish(current) ; 

84 

85 

86 catch (InterruptedException e) 

87 { 

88 } 

89 return null; 

90 } 

91 

92 protected void process(List<Integer> chunks) 
93 { 

94 for (Integer chunk : chunks) 

95 

96 textArea.append(chunk + "\n"); 
97 progressBar. setValue(chunk) ; 
98 } 

99 } 

100 

101 protected void done() 

102 { 

103 StartButton. setEnabled(true) ; 

104 } 

105 } 

106 } 


10.5.2 ”进度 监视 器 


进度 条 是 一 个 很 简单 的 构件 ， 可 以 放 在 一 个 窗 体 中 。 相 比 之 下 ，ProgressMonitor 是 
一 个 完整 的 包含 进度 条 的 对 话 框 (参见 图 10-42 )。 这 个 对 话 框 还 包含 一 个 Cancel 按钮 ， 如 果 
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点 击 该 按钮 ， 那 么 将 会 关闭 监视 器 对 话 框 。 另 外 ， 程 序 ee 
并 终止 了 监视 活动 。( 注 意 : 这 个 类 的 类 名 并 不 是 以 “ 
开头 的 。) 

通过 提供 下 面 这 些 信 息 ， 就 可 以 构建 一 个 进度 监视 从: 

o 在 其 上 弹出 对 话 框 的 父 构 件 。 

e 在 对 话 框 上 显示 的 一 个 对 象 (可 能 是 一 个 字符 串 、 图 

标 或 者 是 一 个 构件 )。 ont en ee a 

ed Pea“) Saas 图 10-42 “一 个 进度 监视 器 对 话 杠 

e 最 大 值 以 及 最 小 值 。 

不 过 ， 进 度 监 视 器 无 法 自己 测量 进度 或 者 取消 活动 。 因 此 ， 仍 须 定 时 调用 setProgress 
方法 设置 进度 值 。( 该 方法 等 价 于 JProgressBar 类 的 setValue 方法 。) 在 取消 监视 肯 活 动 
的 时 候 ， 请 调用 close 方法 来 撤销 对 话 框 。 还 可 以 再 次 调用 start 重新 使 用 该 对 话 框 。 

使 用 进度 监视 器 的 最 大 问题 在 于 处 理 取 消 请 求 ， 因 为 我 们 不 能 将 一 个 事件 处 理 器 附加 到 
Cancel 按钮 上 ， 而 是 应 该 周期 性 地 调用 isCancel 方法 来 观察 程序 用 户 是 否 按 下 了 Cancel 
按钮 。 

如 果 工 作 线 程 可 以 无 限 地 阻塞 下 去 (例如 ， 在 从 网 络 连接 中 读 取 输入 时 )， 那 么 它 就 不 能 
监视 Cancel 按钮 。 在 我 们 的 示例 程序 中 ， 我 们 展示 了 如 何 使 用 定时 器 来 达到 此 目的 ， 另 外 ， 
我 们 还 让 定时 器 负责 更 新 对 进度 的 度量 。 

如 果 运 行 一 下 程序 清单 10-27 中 的 程序 ， 你 会 观察 到 进度 监视 器 对 话 框 有 一 个 很 有 趣 的 
特性 。 该 对 话 框 不 会 立即 出 现 ， 相 反 地 ， 它 会 等 待 一 小 段 时 间 看 看 活动 是 否 已 经 完成 ， 或 者 
是 否 可 能 在 比 对 话 框 出 现 所 需 时 间 更 短 的 时 间 内 完成 。 

使 用 setMi11isToDecideToPopup 方法 可 以 设置 在 构建 对 话 框 对 象 和 确定 是 否 显示 弹 
出 对 话 框 之 间 需 要 等 待 的 毫秒 数 ， 默 认 值 是 500 毫秒 。setMi11isToPopup 是 你 估计 对 话 框 
弹出 所 需 的 时 间 ，Swing 设计 者 将 这 个 值 默认 设置 为 2 秒 。 很 显然 ， 他 们 考虑 了 这 个 事实 ， 
即 Swing 人 PA sil asada 


a 








| ie i 
package rr 
import java.awt.*; 


import javax.swing.*; 


ak 

* A frame that contains a button to launch a simulated activity and a text area for the activity 
* output. 

10 */ 

11 Class ProgressMonitorFrame extends JFrame 


ce ~ K wm A wù N p 


wo 


{ 
13 public static final int TEXT_ROWS = 10; 
14 public static final int TEXT_COLUMNS = 40; 
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16 private Timer cancelMonitor; 

17 private JButton startButton; 

18 private ProgressMonitor progressDialog; 
19 private JTextArea textArea; 

20 private SimulatedActivity activity; 


22 public ProgressMoni torFrame() 


23 { 

24 // this text area holds the activity output 
25 textArea = new JTextArea(TEXT_ROWS, TEXT_COLUMNS) ; 
26 

27 // set up a button panel 

28 JPanel panel = new JPanel (); 

29 StartButton = new JButton("Start"); 

30 panel .add(startButton) ; 

31 

32 add(new JScrol]Pane(textArea), BorderLayout.CENTER) ; 
33 add(panel, BorderLayout. SOUTH) ; 

34 

35 // set up the button action 

36 

37 StartButton.addActionListener(event -> 

38 { 

39 StartButton. setEnab] ed(false) ; 

40 final int MAX = 1000; 

41 

42 // start activity 

43 activity = new SimulatedActivity (MAX) ; 
44 activity.execute(); 

45 

46 // launch progress dialog 

47 progressDialog = new ProgressMonitor(ProgressMonitorFrame. this, 
48 "Waiting for Simulated Activity", null, 0, MAX); 
49 cancelMonitor.start(); 

50 }); 

51 

52 // set up the timer action 

53 

54 cancelMonitor = new Timer(500, event -> 

55 { 

56 if (progressDialog.isCanceled()) 

57 

58 activity.cancel (true); 

59 StartButton. setEnabled(true) ; 

60 

61 else if (activity.isDone()) 

62 { 

63 progressDialog.close(); 

64 StartButton. setEnabled(true) ; 

65 } 

66 else 

67 { 


68 progressDialog.setProgress(activity.getProgress()); 
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70 }); 

71 pack(); 

22 } 

73 

1 Class SimulatedActivity extends SwingWorker<Void, Integer> 
75 { 

76 private int current; 

77 private int target; 

78 

19 /** 

80 * Constructs the simulated activity that increments a counter from 0 to a 
81 * given target. 

82 * @param t the target value of the counter 
83 */ 

84 public SimulatedActivity(int t) 

85 { 

86 current = 0; 

87 target = t; 

88 } 

89 

90 protected Void doInBackground() throws Exception 
91 { 

92 try 

93 

94 while (current < target) 

95 { 

96 Thread.sleep(100) ; 

97 current++; 

98 textArea.append(current + "\n"); 

99 setProgress (current) ; 

100 } 

101 

102 catch (InterruptedException e) 

103 { 

104 } 

105 return null; 

106 } 

107 } 

108 } 





10.5.3 ”监视 输入 流 的 进度 


Swing 包 有 一 个 很 有 用 的 流 过 滤器 ，ProgressMonitorInputStream， 它 可 以 自动 弹出 
一 个 对 话 框 ， 监 视 已 经 从 流 中 读 取 了 多 少 。 

这 个 过 滤器 很 容易 使 用 。 可 以 在 常见 的 过 滤 流 序列 之 间 插 入 ProgressMonitorInput 
Stream。( 请 参阅 第 2 BRKT RN BSAA) 

例如 ， 假 定 你 现在 要 从 一 个 文件 中 读 取 文本 。 首 先 要 使 用 一 个 FileInputStream: 


FileInputStream in = new FileInputStream(f) ; 


通常 情况 下 ， 要 将 in 转换 成 一 个 InputStreamReader; 
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InputStreamReader reader = new InputStreamReader(in) ; 
但 是 ， 为 了 监视 这 个 流 ， 首 先 要 将 这 个 文件 输入 流转 换 成 一 个 具有 进度 监视 器 的 数据 流 : 
ProgressMonitorInputStream progressIn = new ProgressMonitorInputStream(parent, caption, in); 


你 要 提供 一 个 父 构 件 、 一 个 标题 ， 当 然 还 有 要 监视 的 
流 。 进 度 监视 需 流 的 read 方法 只 能 传输 字 节 和 更 新 进度 
对 话 框 。 

现在 可 以 开始 着 手 构建 你 的 过 滤器 序列 : 

InputStreamReader reader = new InputStreamReader(progressIn) ; 

这 束 是 我 们 要 做 的 全 部 内 容 。 当 读 取 文件 的 时 候 ， 进 id ne 
Beth ares A Sas (参见 图 10-43 )。 这 是 一 个 流 过 滤 的 ”图 10-43 用 于 输入 流 的 进度 监视 器 
极 佳 应 用 。 


QO 警告 : 进度 监视 器 流 使 用 InputStream 类 的 available 方法 来 确定 流 中 的 总 字 节 数 。 
但 是 ，available 方法 只 报告 流 中 不 hb 进度 监视 器 适用 于 文件 


以 及 HTTP URL， 因 为 它们 的 长 度 都 是 事先 可 以 知道 它 并 不 适用 于 所 有 的 流 。 


程序 清单 10-28 中 的 程序 可 以 计算 文件 中 的 行 数 。 如 果 读 取 的 是 一 个 大 型 文件 (例如 附 
带 的 代码 中 的 gutenberg 目录 中 的 “The Count of Monte Cristo”)， 那 么 将 会 弹出 进度 对 
话 框 。 | 
如 采用 户 单 击 Cancel 按钮 ， 输 入 流 就 会 关闭 。 因 为 处 理 输入 的 代码 已 经 知道 了 应 该 如 何 
处 理 输 入 结束 ， 所 以 处 理 取 消 请 求 并 不 需要 对 编程 逻辑 做 任何 修改 。 

注意 ， 该 程序 并 没有 使 用 很 高 效 的 方式 来 填充 文本 区 域 。 如 果 首 先 将 文件 读 取 到 一 个 
StringBuffer 中 ， 然 后 将 文本 区 域 的 文本 设置 为 字符 串 缓冲 的 内 容 ， 可 能 会 更 快 一 些 。 不 
过 ， 在 这 个 示例 程序 中 ， 我 们 实际 上 喜欢 这 种 缓慢 的 方式 ， 因 为 它 可 以 让 你 有 更 多 的 时 间 欣 
赏 进度 对 话 框 。 

lb han. ni TARERE: 








package progressMonitorInputStream; 


1 

2 

3 import java.io.*; 

4 import java.nio.file.*; 
5 import java.util.*; 
6 
7 
8 
9 


import javax.swing.*; 


/** 
10 * A frame with a menu to load a text file and a text area to display its contents. The text 
11 * area is constructed when the file is loaded and set as the content pane of the frame when 
12 * the loading is complete. That avoids flicker during loading. 
3 */ 
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14 public class TextFrame extends JFrame 


is { 


16 


public static final int TEXT_ROWS = 10; 
public static final int TEXT_COLUMNS = 40; 


private JMenultem openltem; 
private JMenultem exitItem; 
private JTextArea textArea; 
private JFileChooser chooser; 


public TextFrame() 

{ 
textArea = new JTextArea(TEXT_ROWS, TEXT_COLUMNS) ; 
add(new JScrol1Pane(textArea)) ; 


chooser = new JFileChooser(); 
chooser.setCurrentDi rectory(new File(".")); 


JMenuBar menuBar = new JMenuBar(); 
set JMenuBar (menuBar) ; 
Menu fileMenu = new JMenu("File"); 
menuBar.add(fi leMenu) ; 
openItem = new JMenuItem("Open") ; 
openItem.addActionListener(event -> 

{ 

try 


openFile(); 


catch (IOException exception) 
{ 
exception. printStackTrace() ; 
} 
}); 


fileMenu.add(openItem) ; 
exitItem = new JMenultem("Exit"); 
exitItem.addActionListener(event -> System.exit(0)); 
fileMenu.add(exitItem) ; 
pack() ; 

} 


/[** 
* Prompts the user to select a file, loads the file into a text area, and sets it as the 


* content pane of the frame. 
$ 


public void openFile() throws IOException 
{ 


int r = chooser.showOpenDialog(this) ; 
if (r != JFileChooser.APPROVE_OPTION) return; 
final File f = chooser.getSelectedFile() ; 


// set up stream and reader filter sequence 
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68 InputStream fileIn = Files.newInputStream(f.toPath()); 

69 final ProgressMonitorInputStream progressIn = new ProgressMoni torInputStream( 
70 this, "Reading ”+ f.getName(), fileIn); 

71 

n textArea.setText(""); 

73 

74 SwingWorker<Void, Void> worker = new SwingWorker<Void, Void>() 
75 

76 protected Void doInBackground() throws Exception 

77 

78 try (Scanner in = new Scanner(progressIn, "UTF-8")) 
79 

80 while (in, hasNextLine()) 

81 { 

82 String line = in.nextLine(); 

83 textArea.append(line) ; 

84 textArea.append("\n") ; 

85 

86 } 

87 return null; 

88 } 

89 局 

90 WOrker,execute() ; 





e JProgressBar() 


e JProgressBar(int direction) 
e JProgressBar(int min, int max) 
e JProgressBar(int direction, int min, int max) 


按照 给 定 的 方向 、 最 小 值 以 及 最 大 值 构 建 一 个 滑动 条 。 


参数 : direction SwingConstants .HORIZONTAL 或 者 Swi ngConstants . VERTICAL 
其 中 之 一 。 默 认 值 是 水 平方 向 
min, max 进度 条 的 最 大 值 和 最 小 值 。 默 认 值 是 0 和 100 


eint getMinimum( ) 

e int getMaximum( ) 

evoid setMinimum(int value) 

e void setMaximum(int value) 
获取 并 设置 最 小 值 以 及 最 大 值 。 

e int getValue() 

evoid setValue(int value) 


获取 并 设置 当前 的 值 。 
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e String getString() 

e void setString(String s) 
获取 并 设置 在 进度 条 中 显示 的 字符 串 。 如 果 该 字符 串 为 nu11， 和 那么 将 会 显示 一 个 默认 
字符 串 “n% ”。 

èe boolean isStringPainted ( ) 

e void setStringPainted(boolean b) 
获取 并 设置 “字符 串 绘制 ”属性 。 如 果 这 个 属性 是 true， 那 么 会 在 进度 条 的 上 面 绘制 
出 一 个 字符 串 。 默 认 值 是 false。 

e boolean isIndeterminate() 1.4 

e void setIndeterminate(boolean b) 1.4 
获取 并 设置 “不 确定 ”属性 。 如 果 该 属性 是 true， 那 么 该 进度 条 就 会 变 成 一 个 前 后 移 
动 的 滑动 块 ， 表 明 一 个 持续 时 间 不 可 知 的 等 待 。 默 认 值 是 false, 





e ProgressMonitor (Component parent, Object message, String note, int 


min, int max) 


构建 一 个 进度 监视 项 对 话 框 。 


参数 : parent 父 构件 ， 在 其 上 弹出 对 话 框 
message 对 话 框 中 要 显示 的 消息 对 象 
note 在 消息 下 显示 的 可 选 字 符 串 。 如 果 该 值 为 nu11， 则 不 会 为 
注释 设置 任何 空间 ， 并 且 随 后 对 setNote 的 调用 不 会 产生 
任何 效果 
min, max 进度 条 的 最 小 值 以 及 最 大 值 
e void setNote(String note) 
更 改 注释 文本 。 
e void setProgress(int value) 
将 进度 条 的 值 设置 为 给 定 值 。 
e void close() 
关闭 对 话 框 。 


e boolean isCanceled() 


如 果 用 户 取 消 了 对 话 框 ， 则 返回 true, 





eProgressMonitorInputStream(Component parent, Object message, 
InputStream in) 
用 相关 联 的 进度 监视 器 对 话 框 构建 一 个 输入 流 过 滤 需 。 
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参数 : parent 父 构 件 ， 在 其 上 弹出 对 话 框 
message 在 对 话 框 中 显示 的 消息 对 象 
in 正 被 监视 的 输入 流 


10.6 ”构件 组 织 器 和 装饰 器 


我 们 在 这 里 通过 展示 一 些 帮 助 组 织 其 他 构件 的 构件 来 结束 对 高 级 Swing 特性 的 讨论 。 这 
些 构件 包括 分 割 面板 、 选 项 卡 面板 以 及 桌面 面板 。 分 割 面板 是 将 一 个 区 域 分 割 成 多 个 边界 可 
调整 的 区 域 的 一 种 机 制 。 选 项 卡 面板 使 用 选项 卡 分 割 器 ， 人 允许 用 户 浏览 多 个 面板 。 桌 面 面 板 
可 用 来 实现 显示 多 个 内 部 框 体 的 应 用 。 最 后 ,我 们 将 讨论 层 ， 即 可 以 释 加 在 其 他 构件 之 上 的 
Be MAE o 


10.6.1 分 割 面板 


分 割 面板 可 以 将 一 个 构件 分 割 成 两 部 分 ， 并 且 
这 两 部 分 之 间 具 有 可 调整 的 边界 。 图 10-44 显示 了 
一 个 具有 两 个 分 割 面板 的 框 体 。 外 部 面板 中 的 构件 
是 垂直 布局 的 ， 底 部 是 一 个 文本 区 ， 上 面 是 另外 一 
个 分 割 面 板 。 上 面 这 个 分 割 面板 是 水 平分 割 的 ， 左 
边 是 一 个 列表 ， 右 边 是 一 个 包含 图 形 的 标签 。 

如 果 要 构建 一 个 分 割 面板 ， 需 要 设 定 一 个 方 
H, #18 X JSplitPane.HORIZONTAL_SPLIT 和 m m 
JSplitPane.VERTICAL_SPLIT 中 的 之 一 ， 随 后 图 10-44 具有 两 个 嵌 套 的 分 割 面板 的 框 体 
是 两 个 构件 。 例 如 : 

JSplitPane innerPane = new JSplitPane(JSplitPane.HORIZONTAL_SPLIT, planetList, planetImage) ; 


这 就 是 你 要 做 的 全 部 事情 。 如 果 你 喜欢 ， 可 以 为 分 割 器 添加 “一 触 即 展 ”的 图 标 。 你 可 
以 在 图 10-44 中 的 顶层 面板 中 看 到 这 些 图标 。 在 Metal 外 观 模 式 中 ， 它 们 是 小 箭头 的 形式 。 
如 果 你 点 中 它们 中 的 一 个 ， 那 么 分 割 器 将 会 一 直 沿 着 箭头 指定 的 方向 移动 ， 将 其 中 的 一 个 面 
板 完全 展开 。 

如 果 要 添加 这 项 功能 ， 请 调用 : 

innerPane. setOneTouchExpandable(true) ; 

当 用 户 调整 分 割 器 的 时 候 ,“ 连 续 布 局 ”特性 会 一 直 不 断 地 刷新 这 两 个 构件 的 内 容 。 这 种 
情形 看 似 经 典 ， 实 则 运行 缓慢 。 你 可 以 调用 下 面 这 个 方法 启动 该 功能 : 

innerPane.setContinuousLayout (true) ; 

在 这 个 示例 程序 中 ， 我 们 将 分 割 器 设 为 默认 状态 〈 非 连续 布局 ) 。 拖 动 它 的 时 候 ， 只 能 移 
动 一 个 黑色 的 轮廓 。 当 释放 鼠标 完成 这 项 操作 时 ， 才 会 刷新 这 些 构 件 。 
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在 简单 明了 的 程序 清单 10-29 中 ， 组 装 了 一 个 具有 行星 数据 的 列表 框 。 当 用 户 进 行 选择 
的 时 候 ， 行 星 的 图 片 便 在 右边 显示 了 出 来 ， 并 且 在 底部 的 文本 区 显示 出 对 它 的 描述 。 当 你 运 
行 这 个 程序 的 时 候 ， 请 调整 一 下 分 割 器 ， 并 试 试 一 触 即 展 和 连续 布局 这 些 特 性 。 


Pare) ene Š 
apm TS i nee Mg E et E Ne i 





package splitPane; 
import java.awt.*; 
import javax.swing.*; 


/** 
* This frame consists of two nested split panes to demonstrate planet images and data. 
党 

10 Class SplitPaneFrame extends JFrame 

u { 

12 private static final int DEFAULT_WIDTH = 300; 

13 private static final int DEFAULT_HEIGHT = 300; 


ona ns OO N^ A OH N p 


15 private Planet[] planets = { new Planet("Mercury", 2440, 0), new Planet(“Venus", 6052, 0), 


16 new Planet("Earth", 6378, 1), new Planet("Mars", 3397, 2), 

17 new Planet("Jupiter", 71492, 16), new Planet("Saturn", 60268, 18), 
18 new Planet("Uranus", 25559, 17), new Planet("Neptune", 24766, 8), 
19 new Planet("Pluto", 1137, 1), }; 


21 public SplitPaneFrame () 


{ 
23 setSize(DEFAULT_WIDTH, DEFAULT_HEIGHT) ; 


25 // set up components for planet names, images, descriptions 
26 

27 final JList<Planet> planetList = new JList<>(planets) ; 

28 final JLabel planetImage = new JLabel(); 

29 final JTextArea planetDescription = new JTextArea(); 

30 

31 planetList.addListSelectionListener(event -> 

32 { 

33 Planet value = (Planet) planetList.getSelectedValue() ; 
34 

35 // update image and description 

36 

37 planetImage. setIcon(value.getImage()) ; 

38 planetDescription.setText (value.getDescription()) ; 

39 )); 

40 

41 // set up split panes 

42 

43 }SplitPane innerPane = new JSplitPane(JSplitPane.HORIZONTAL_SPLIT, planetList, planetImage) ; 
44 

45 innerPane. setContinuousLayout (true) ; 

46 innerPane, setOneTouchExpandable(true) ; 


48 }SplitPane outerPane = new JSplitPane(JSplitPane.VERTICAL_SPLIT, innerPane, 





592 Java ZSRR KT ZRH 


49 planetDescription); 


51 add(outerPane, BorderLayout.CENTER) ; 
52 } 
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e JSplitPane() 
èe JSplitPane(int direction) 





e JSplitPane(int direction, boolean continuousLayout ) 

èe JSplitPane(int direction, Component first, Component second) 

e JSplitPane(int direction, boolean continuousLayout, Component 
first, Component second) 


构建 一 个 新 的 分 割 面板 。 


参数 : direction HORIZONTAL_SPLIT 或 VERTICAL_SPLIT 
continousLayout 如 果 为 true， 那 么 当 移动 分 割 器 时 ， 该 构件 是 连续 
更 新 的 
first，second 要 添加 的 构件 


e boolean isOneTouchExpandabl1e() 

e void setOneTouchExpandable(boolean b) 
获取 并 设置 “一 触 即 展 ”属性 。 如 果 设置 了 该 属性 ， 那 么 该 分 割 器 具有 两 个 图 标 以 完 
全 展开 分 割 面板 某 一 侧 的 构件 。 

èe boolean isContinuousLayout( ) 

e void setContinuousLayout(boolean b) 
获取 并 设置 “连续 布局 ”属性 。 如 果 设 置 了 该 属性 ， 那 么 当 移动 分 割 器 的 时 候 ， 该 构 
件 是 连续 更 新 的 。 

evoid setLeftComponent(Component c) 

e void setTopComponent(Component c) 
这 两 个 操作 具有 同等 效果 ， 用 于 将 c 设置 为 分 割 面板 中 第 一 个 构件 。 

e void setRightComponent(Component c) 

e void setBottomComponent(Component c) 


这 两 个 操作 具有 同等 效果 ， 用 于 将 c 设置 为 分 割 面板 中 第 二 个 构件 。 
10.6.2 ”选项 卡 面板 


选项 卡 面板 是 一 种 大 家 都 很 熟悉 的 用 户 界面 设施 ， 它 可 以 将 一 个 复杂 的 对 话 框 分 割 成 相 
关 选 项 的 子 集 ， 也 可 以 使 用 选项 卡 让 用 户 浏览 一 组 文档 或 图 像 (参见 图 10-45 )。 这 也 是 我 们 
在 示例 程序 中 要 讲解 的 。 
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为 了 创建 一 个 选项 卡 面板 ， 首 先 要 构建 一 个 JTabbedPane 对 象 ， 然 后 向 其 中 添加 选项 卡 。 


JTabbedPane tabbedPane = new JTabbedPane(); 
tabbedPane.addTab(title, icon, component) ; 


addTab 方法 最 后 一 个 参数 的 类 型 为 Component。 
为 了 向 同一 个 选项 卡 中 添加 多 个 构件 ， 首 先 要 将 这 些 
构件 包装 到 一 个 容器 中 ， 例 如 一 个 UPane1。 

该 方法 中 的 图 标 参数 是 一 个 可 选项 。addTab Jy 
法 并 非 一 定 要 有 一 个 图 标 参数 ， 例 如 : 

tabbedPane.addTab(title, component) ; 

也 可 以 使 用 insertTab 方 法， 将 一 个 选项 卡 添 
加 到 选项 卡 集中 : 

tabbedPane.insertTab(title, icon, component, tooltip, index); 


如 果 要 从 选项 卡 集中 删 掉 一 个 选项 卡 ， 请 使 用 


tabPane. removeTabAt (index) ; 
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图 10-45 一 个 选项 卡 面板 





向 选项 集中 添加 一 个 新 的 选项 卡 时 ， 并 不 能 自动 将 其 显示 出 来 ， 必 须 使 用 setSelected 
Index 方法 选 定 它 。 例 如 ， 下 面 这 段 代码 展示 了 怎样 将 刚刚 添加 到 末尾 的 选项 卡 显 示 出 来 : 


tabbedPane. setSelectedIndex(tabbedPane.getTabCount() - 1); 


如 果 有 很 多 选项 卡 ， 那 么 它们 会 占用 很 多 空间 。 
从 Java SE 1.4 开 始 ， 可 以 将 选项 卡 以 滚动 模式 显示 出 
来 ， 在 这 种 模式 中 ， 只 显示 一 行 面板 ， 但 是 会 配 有 一 
组 箭头 允许 用 户 滚动 显示 这 些 选项 卡 (参见 图 10-46 )。 

调用 下 面 这 个 方法 ， 就 可 以 将 选项 卡 布局 设置 为 
隐藏 格式 或 者 滚动 模式 : 

tabbedPane. setTabLayoutPolicy(JTabbedPane.WRAP_TAB_LAYOUT) ; 
或 者 

tabbedPane.setTabLayoutPolicy(JTabbedPane. SCROLL_TAB_LAYOUT) ; 


选项 卡 标签 可 以 有 快捷 键 ， 就 像 菜 单项 一 样 。 例 如 


int marsIndex = tabbedPane.index0fTab("Mars"); 
tabbedPane.setMnemonicAt(marsIndex, KeyEvent.VK_M) ; 





图 10-46 ”具有 滚动 选项 卡 的 选项 卡 面板 


之 后 M 就 会 有 下 划 线 ， 而 程序 用 户 可 以 通过 键 人 ALT+M 来 选择 选项 卡 。 
可 以 在 选项 卡 标题 栏 中 添加 任何 构件 ， 此 时 ， 首 先 需要 添加 选项 卡 ， 然 后 调用 : 


tabbedPane.setTabComponentAt(index, component) ; 


在 我 们 的 示例 程序 中 ， 我 们 向 Pluto 选项 卡 中 添加 了 一 个 “关闭 框 ” 《因为 毕竟 有 些 天 文 
学 家 不 认为 冥王 星 算得 上 一 颗 真正 的 行星 )。 实 现 这 项 任务 的 方法 是 将 选项 卡 构件 设置 为 包 
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含 两 个 构件 的 面板 : 具有 图 标 和 选项 卡 文本 的 标签 ， 以 及 具有 能 够 移 除 该 选项 卡 的 动作 监听 
A HY) R PENE o 

这 个 示例 程序 展示 了 选项 卡 面板 一 个 非常 有 用 的 技术 。 有 时 候 需 要 在 一 个 构件 显示 之 前 
对 其 进行 更 新 。 在 我 们 这 个 示例 程序 中 ， 只 在 用 户 真正 点 击 一 个 选项 卡 的 时 候 才 将 行星 图 片 
载 人 。 

为 了 在 用 户 任 何 时 候 点 击 一 个 新 选项 卡 时 都 能 获得 通知 ， 需 要 为 选项 卡 面板 安装 一 个 
ChangeListener。 注 意 ， 必 须 为 选项 卡 面板 本 身 添 加 监听 器 ， 而 不 是 它 所 包含 的 任何 一 个 
选项 卡 构件 。 

tabbedPane.addChangeListener(listener) ; 

当 用 户 选 定 一 个 选项 卡 时 ， 就 会 调用 修改 监听 器 的 stateChanged 方法 。 可 以 将 选项 卡 
面板 作为 事件 源 来 读 取 ， 并 调用 getSelectedIndex 方法 就 可 以 查 明 将 要 显示 哪个 面板 。 


public void stateChanged(ChangeEvent event) 


int n = tabbedPane.getSelectedIndex() ; 
loadTab(n) ; 


在 程序 清单 10-30 中 ， 我 们 首先 将 选项 卡 构件 设置 为 nu11。 当 选 定 一 个 新 的 面板 时 ， 我 
们 会 测试 它 的 构件 是 否 仍 为 nu11。 如 果 为 nu11， 我 们 会 用 一 个 图 片 替 代 显 示 。( 这 种 情况 在 
点 击 一 个 选项 卡 的 那 一 瞬间 发 生 ， 你 将 不 会 看 到 任何 空 的 面板 。) 只 是 为 了 有 趣 ， 我 们 还 将 这 
个 图 标 从 黄色 球 更 改 为 红色 球 以 指示 我 们 已 经 访问 过 的 那些 面板 。 





1 package tabbedPane; 
2 
3 Import java.awt.*; 
4 
5 import javax.swing.*; 
é 
7 /** 
8 * This frame shows a tabbed pane and radio buttons to switch between wrapped and scrolling tab 
9 * layout. 

* 


11 public class TabbedPaneFrame extends JFrame 


13 private static final int DEFAULT_WIDTH = 400; 
14 private static final int DEFAULT_HEIGHT = 300; 


16 private JTabbedPane tabbedPane; 
18 public TabbedPaneFrame() 
{ 
20 SetSize(DEFAULT_WIDTH, DEFAULT_HEIGHT) ; 


22 tabbedPane = new JTabbedPane() ; 
23 // we set the components to null and delay their loading until the tab is shown 
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// for the first time 


ImageIcon icon = new ImageIcon(getClass() .getResource("yel low-ball.gif")); 


tabbedPane.addTab("Mercury”, icon, null); 


tabbedPane.addTab("Venus", icon, null); 
tabbedPane.addTab("Earth", icon, null); 
tabbedPane.addTab("Mars", icon, null); 
tabbedPane.addTab("Jupiter", icon, null); 
tabbedPane.addTab("Saturn", icon, null); 
tabbedPane.addTab("Uranus", icon, null); 
tabbedPane.addTab("Neptune", icon, null); 
tabbedPane.addTab("Pluto", null, null); 


final int plutoIndex = tabbedPane.index0fTab("Pluto"); 

JPanel plutoPanel = new JPanel (); 

plutoPanel.add(new JLabel("Pluto", icon, SwingConstants.LEADING)) ; 
JToggleButton plutoCheckBox = new JCheckBox() ; 
plutoCheckBox.addActionListener(event -> tabbedPane. remove(plutoIndex)) ; 
plutoPanel .add(plutoCheckBox) ; 

tabbedPane.setTabComponentAt(plutoIndex, plutoPanel); 


add(tabbedPane, Center ) ; 
tabbedPane.addChangeListener(event -> 
// check if this tab still has a null component 
if (tabbedPane.getSelectedComponent() == null) 
// set the component to the image icon 


int n = tabbedPane.getSelectedIndex() ; 
loadTab(n) ; 
} 
Ds 


loadTab(0) ; 


JPanel buttonPanel = new JPanel (); 
ButtonGroup buttonGroup = new ButtonGroup(); 
JRadioButton wrapButton = new JRadioButton("Wrap tabs"); 
wrapButton. addActionListener(event -> 

tabbedPane. setTabLayoutPolicy(JTabbedPane.WRAP_TAB_LAYOUT)) ; 
buttonPanel .add(wrapButton) ; 
buttonGroup.add(wrapButton) ; 
wrapButton. setSelected(true) ; 
JRadioButton scrollButton = new JRadioButton("Scrol] tabs"); 
scrol|Button.addActionListener(event -> 

tabbedPane. setTabLayoutPolicy(JTabbedPane.SCROLL_TAB_LAYOUT)) ; 
buttonPanel .add(scrol|Button) ; 
buttonGroup.add(scrol]Button) ; 
add(buttonPanel, BorderLayout. SOUTH) ; 
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79 /** 
80 * Loads the tab with the given index. 

81 * @aram n the index of the tab to load 

82 */ 

83 private void loadTab(int n) 

ao à { 

85 String title = tabbedPane.getTitleAt(n) ; 

86 ImageIcon planetIcon = new ImageIcon(getClass().getResource(title + ".gif")); 
87 tabbedPane.setComponentAt(n, new JLabel(planetIcon)) ; 

88 

89 // indicate that this tab has been visited--just for fun 

90 

91 tabbedPane.setIconAt(n, new ImageIcon(getClass() .getResource("red-ball.gif"))); 
92 } 

93 } 








e Jl abbedPane( ) 
èe JTabbedPane(int placement) 
构建 一 个 选项 卡 面板 。 
参数 . placement SwingConstants.TOP、 SwingConstants.LEFT, 
SwingConstants.RIGHT 5K SwingConstants.BOTTOM 其 
中 之 一 
e void addTab(String title, Component c) 
e void addTab(String title, Icon icon, Component c) 
evoid addTab(String title, Icon icon, Component c, String tooltip) 
回 选 项 卡 面板 的 末尾 添加 一 个 选项 卡 。 
evoid insertTab(String title, Icon icon, Component c, String 
tooltip, int index) 
在 选项 卡 面 板 的 给 定 索引 处 添加 一 个 选项 卡 。 
evoid removeTabAt(int index) 
移 除 指定 索引 处 的 选项 卡 。 
e void setSelectedIndex(int index) 
选 定 给 定 索引 处 的 选项 卡 。 
è int getSelectedIndex() 
获取 选 定 的 选项 卡 的 索引 。 
e Component getSelectedComponent( ) 
返回 选 定 的 选项 卡 构件 。 
e String getTitleAt(int index) 
ə void setTitleAt(int index, String title) 
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e Icon getIiconAt(Cint index) 
e void setIconAt(Cint index, Icon icon) 
e Component getComponentAt(int index) 
e void setComponentAt(int index, Component c) 
获取 或 设置 给 定 索引 处 的 标题 、 图 标 或 者 构件 。 
eint indexOfTab(String title) 
eint indexOfTab(Icon icon) 
è int indexOfComponent(Component c) 
返回 具有 给 定 的 标题 、 图 标 或 者 构件 的 索引 。 
e int getTabCount() 
返回 该 选项 卡 面 板 上 的 选项 卡 总 数 。 
e int getTabLayoutPolicy() 
èe void setTabLayoutPolicy(int policy) 1.4 
获得 或 者 设置 选项 卡 布 局 策略 。policy 是 JTabbedPane.WRAP_TAB_LAYOUT 或 
JTabbedPane.SCROLL_TAB_LAYOUT 其 中 之 一 。 
e int getMnemonicAt(int index) 1.4 
e void setMnemonicAt(int index, int mnemonic) 
获得 或 者 设置 给 定 选项 卡 索引 的 快捷 字符 。 这 个 字符 是 作为 KeyEvent 类 的 一 个 VK_X 
常量 指定 的 ，-1 表示 没有 快捷 方式 。 
e Component getTabComponentAt(int index) 6 
e void setTabComponentAt(int index, Component c) 6 
获得 或 者 设置 构件 ， 用 于 绘制 给 定 索 引 的 选项 卡 的 标题 栏 。 如 果 该 构件 为 nu11， 则 绘 
制 选项 卡 的 图 标 和 标题 ， 否 则 ， 在 选项 卡 中 只 绘制 给 定 的 构件 。 
eint indexOfTabComponent(Component c) 6 
返回 具有 给 定 标题 栏 构件 的 选项 卡 的 索引 。 
èe void addChangeListener(ChangeListener listener) 


添加 一 个 修改 监听 器 ， 当 用 户 选 定 了 男 一 个 选项 卡 的 时 候 ， 会 通知 它 。 


10.6.3 ”桌面 面板 和 内 部 框 体 


很 多 应 用 会 将 信息 在 多 个 窗口 中 显示 ， 并 且 这 些 窗口 都 包含 在 一 个 大 的 框 体 中 。 如 果 将 


应 用 框 体 最 小 化 ， 那 么 它 当 中 的 所 有 窗口 会 在 同一 时 间 全 部 隐藏 起 来 。 在 Windows 环境 中 ， 
这 种 用 户 界面 有 时 称 作 多 文档 界面 ( multiple document interface, MDI), KI 10-47 显示 了 一 
个 使 用 到 该 界面 的 典型 应 用 程序 。 


有 一 段 时 间 ， 这 种 用 户 界 面 格式 非常 流行 ， 不 过 最 近 几 年 已 经 变 得 不 那么 常用 了 。 现 在 ,很 


多 应 用 为 每 个 文档 只 显示 一 个 独立 的 顶层 框 体 。 哪 一 种 格式 更 好 呢 ? MDI 减 少 了 窗口 的 混乱 ， 
但 是 如 果 拥有 了 独立 的 顶层 窗口 ， 意 味 着 可 以 使 用 主 窗 口 系统 的 按钮 及 热 键 浏 览 所 有 窗口 。 
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©) int indexOfTab(Icon icon) 
e) int indexOfComponent(Component c)f] 
return the index of the tab with the given title, icon, or component.{ 
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图 10-47 一 个 多 文档 界面 的 应 用 


1. 显示 内 部 框 体 

在 Java 环境 中 ， 不 能 完全 依赖 于 主机 窗口 系统 提供 的 功能 ， 让 你 的 应 用 管理 它 自己 的 框 
体 还 是 很 有 必要 的 。 

图 10-48 显示 了 一 个 具有 三 个 内 部 框 体 的 Java 应 用 程序 ， 其 中 的 两 个 有 一 些 边框 装饰 ， 
用 于 对 它们 进行 最 大 化 和 图 标 显示 ， 第 三 个 已 经 处 于 图 标 状态 。 

在 Metal 外 观 模式 中 ， 内 部 框 体 具有 独一无二 的 “grabber” 区 域 ， 可 以 让 你 随意 移动 这 
些 框 体 ， 并 可 以 通过 拖 动 用 来 调整 大 小 的 角 来 更 改 窗口 的 大 小 。 

为 了 实现 这 项 功能 ， 请 遵循 下 面 几 步 : 

1 ) 在 该 应 用 中 使 用 常规 的 JFrame, 

2) 向 该 JFrame 添加 JDesktopPane, 


desktop = new JDesktopPane() ; 
add(desktop, BorderLayout.CENTER) ; 


3) 构建 JInternalFrame 窗口 ， 可 以 设 定 是 否 需 要 更 改 框 体 大 小 和 关闭 框 体 的 图 标 。 
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通常 情况 下 ， 需 要 添加 所 有 的 图 标 。 


JInternalFrame iframe = new JInternalFrame(title, 
true, // resizable 
true, // closable 
true, // maximizable 
true); // iconifiable 


4) 向 该 内 部 框 体 中 添加 构件 。 
iframe.add(C，BorderLayout ,CENTER) ; 
5 ) 设置 该 内 部 框 体 的 图 标 。 该 图 标 会 显示 在 框 体 左上 角 。 


iframe,SetFrameICon(icon) ; 


图 标 化 图 标 RALAR ”关闭 图 标 


FF internalFrametest 


框 体 图 标 


桌面 面板 





图 标 化 内 部 框 体 
图 10-48 具有 三 个 内 部 框 体 的 Java 应 用 程序 


注意 : 在 Metal 外 观 模式 的 当前 版 本 中 ， 框 体 图 标 并 不 在 图 标 化 的 框 体 中 显示 出 来 。 


6 ) 设置 内 部 框 体 的 大 小 。 和 常规 框 体 一 样 ， 内 部 框 体 初始 大 小 为 0x 0 个 像素 。 因 为 你 
并 不 希望 内 部 框 体 在 另 一 个 框 体 上 面 重 倒 地 显示 出 来 ， 因 此 ; 应 该 为 下 一 个 框 体 使 用 一 个 变 
EME. (EH reshape 方法 对 框 体 的 位 置 和 大 小 进行 设置 : 

iframe. reshape (nextFrameX, nextFrameY, width, height); 

7) 和 JFrames 一 样 ， 需 要 将 该 框 体 设 为 可 见 的 。 


iframe. setVisible(true) ; 
注意 : 在 Swing 的 早期 版 本 ， 内 部 框 体 自动 是 可 见 的 ， 因 此 就 不 需要 调用 这 个 方法 了 。 


8) 将 该 框 体 添 加 到 JDesktopPane 中 : 
desktop. add (i frame) ; 
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9) 你 可 能 想 使 新 的 框 体 成 为 选 定 框 体 。 对 于 桌面 上 的 内 部 框 体 ， 只 有 选 定 的 框 体 才 能 
接收 键盘 焦点 。 在 Metal 外 观 模式 中 ， 选 定 框 体 具有 蓝 色 标题 栏 ， 相 反 地 ， 其 他 框 体 是 灰色 
标题 栏 。 可 以 使 用 setSelected 方法 选 定 一 个 框 体 。 不 过 ， 这 种 “ 选 定 ” 属 性 可 能 会 被 否 
决 掉 ， 当 前 选 定 的 框 体 可 以 拒绝 放弃 焦点 。 在 这 种 情况 下 ，setSelected 方法 会 抛 出 一 个 
PropertyVetoException 异常 让 你 处 理 。 

try 


iframe. setSelected(true): 


} 
catch (PropertyVetoException ex) 


{ 
// attempt was vetoed 


10) 你 可 能 希望 下 一 个 内 部 框 体 的 位 置 能 够 向 下 移动 ， 使 得 不 至 于 覆盖 已 经 存在 的 框 
体 。 框 体 之 间 的 合适 距离 是 标题 栏 的 高 度 ， 可 以 通过 下 面 的 方式 获得 。 


int frameDistance = iframe.getHeight() - iframe.getContentPane() ,getHeight(); 


11) 使 用 该 距离 确定 下 一 个 内 部 框 体 的 位 置 。 


nextFrameX += frameDistance: 

nextFrameY += frameDistance; 

if (nextFrameX + width > desktop. getWidth()) 
nextFrameX = 0; 

if (nextFrameY + height > desktop. getHeight()) 
nextFrameY = 0; 


2. 级 联 与 平 铺 

在 Windows 环境 中 ， 有 一 些 用 于 级 联 及 平 铺 窗口 的 标准 命令 (参见 图 10-49 及 图 10-50 )。 
Java 语言 的 JDesktopPane 类 和 JInternalFrame 类 对 这 些 操作 未 提供 任何 内 置 支 持 。 在 
程序 清单 10-31 中 ， 我 们 将 展示 如 何 实现 这 些 操作 。 





图 10-49 级 联 的 内 部 框 体 
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为 了 级 联 所 有 的 窗口 ， 可 以 将 这 些 窗 口 重新 绘制 成 同样 的 大 小 ， 并 交错 排列 它们 的 位 
置 。JDesktopPane 类 的 getA11Frames 方法 可 以 返回 一 个 所 有 内 部 框 体 的 数组 。 


JInternalFrame[] frames = desktop.getAl|Frames() ; 

不 过 ， 要 注意 一 下 框 体 的 状态 。 一 个 内 部 框 体 可 以 具有 下 面 三 种 状态 之 一 : 

e 图 标 

e 可 放 缩 

e 最 大 化 

可 以 使 用 isIcon 方法 确定 哪些 内 部 框 体 当 前 是 处 于 图 标 状 态 ， 因 而 应 该 跳 过 。 但 是 ， 
如 果 一 个 框 体 处 于 最 大 状态 ， 那 么 首先 要 通过 调用 setMaximum( false) 方法 将 它 设置 为 可 
放 缩 状态 。 这 是 另外 一 个 可 能 被 否决 掉 的 属性 ， 因 此 你 必须 捕获 PropertyVetoException 
FES o 

下 面 这 个 循环 用 于 级 联 一 个 桌面 上 的 所 有 内 部 框 体 : 


for (JInternalFrame frame : desktop.getAllFrames()) 
if (!frame.isIcon()) 


try 
{ 

// try to make maximized frames resizable; this might be vetoed 

frame, setMaximum(fal se) ; 

frame.reshape(x, y, width, height); 

x += frameDistance; 

y += frameDistance; 

// wrap around at the desktop edge 


if (x + width > desktop.getWidth()) x = 0; 
if (y + height > desktop.getHeight()) y = 0; 
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catch (PropertyVetoException ex) 
{} 
} 
} 
平 铺 框 体 更 具 技 巧 性 ， 尤 其 是 当 框 体 数 不 是 一 个 完全 平方 数 时 。 首 先 ， 计 算出 不 是 图 标 
的 框 体 数 。 然 后 ， 按 照 下 面 的 方法 计算 行 数 : 


int rows = (int) Math.sqrt(frameCount) ; 
然后 是 计算 列 数 : 

int cols = frameCount / rows; 
除了 最 后 一 列 是 : 

int extra = frameCount % rows; 


其 余 每 列 的 行 数 是 rows + 1, 
下 面 这 个 循环 用 于 平 铺 桌 面 上 的 所 有 内 部 框 体 : 


int width = desktop,getWidth() / cols; 

int height = desktop.getHeight() / rows; 

int r= 0; 

int c = 0; 

for (JInternalFrame frame : desktop.getAllFrames()) 





if (!frame.isIcon()) 


try 
{ 
frame. setMaximum(false) ; 
frame.reshape(c * width, r * height, width, height); 
r++} 
if (r == rows) 


rak 
CHi 
if (c == cols - extra) 
{ 
// start adding an extra row 
rOWS++; 
height = desktop.getHeight() / rows; 


} 


catch (PropertyVetoException ex) 
{} 
} 
这 个 示例 程序 演示 了 男 一 个 常用 的 框 体 操作 : 将 所 选择 的 框 体 从 当前 框 体 转换 为 下 一 个 
非 图 标 框 体 。 此 时 ， 首 先 遍 历 所 有 的 框 体 并 调用 isSelected 方法 ， 直 到 发 现 当前 选 定 的 框 
体 为 止 。 然 后 ， 查 找 框 体 序列 中 下 一 个 非 图 标 框 体 ， 进 而 通过 如 下 调用 选中 它 : 
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frames [next] .setSelected(true) ; 

正如 前 面 那样 ， 该 方法 会 抛 出 一 个 PropertyVetoException 异常 ， 在 这 种 情况 下 ， 需 
要 一 直 进 行 监视 。 如 果 返 回 到 原先 那个 框 体 ， 那 么 其 他 任何 框 体 都 无 法 选 定 ， 因 此 只 有 放 
弃 。 下 面 是 完整 的 循环 代码 : 

JInternalFrame[] frames = desktop.getAllFrames(); 

for (int i = 0; i < frames.length; i++) 


if (frames [i] .isSelected()) 
{ 


// find next frame that isn't an icon and can be selected 
int next = (i + 1) % frames. length; 


while (next != 7) 
if (!frames [next] .isIcon()) 


try 

{ 
// all other frames are icons or veto selection 
frames [next] .setSelected(true) ; 
frames [next] .toFront(); 
frames [i] .toBackQ) ; 
return; 


} 
catch (PropertyVetoException ex) 
{} 


next = (next + 1) % frames. length; 
} 

} 

3. 否决 属性 设置 

到 现在 为 止 ， 你 已 经 看 到 所 有 这 些 否 决 异 常 ， 那 么 你 可 能 会 问 ， 框 体 是 怎样 发 布 一 个 否 
决 的 呢 ? JInternalFrame 类 使 用 了 一 种 很 少 使 用 的 JavaBean 机 制 来 监视 这 些 属 性 设置 。 
我 们 不 会 详细 讨论 这 种 机 制 。 但 是 ， 我 们 将 展示 框 体 是 怎样 对 属性 更 改 发 送 否决 请 求 的 。 

框 体 通常 并 不 想 使 用 否决 机 制 以 抗议 将 窗口 图 标 化 或 失去 焦点 ， 但 是 对 于 框 体 来 说 ， 检 查 
它们 是 不 是 可 以 关闭 则 是 很 常见 的 。 可 以 使 用 JInterna1Frame 类 的 setC1osed 方 法 关闭 一 
个 窗口 。 因 为 该 方法 是 可 否决 的 ， 因 此 在 进行 更 改 之 前 ， 它 会 调用 所 有 已 注册 的 可 否决 的 更 改 
监听 器 (vetoable change listener)。 这 样 就 赋予 每 个 监听 需 抛 出 一 个 PropertyVetoException 
异常 的 机 会 ， 并 且 在 它 更 改 任何 设置 之 前 , 终止 对 setClosed 的 调用 。 

在 我 们 的 示例 程序 中 ， 我 们 建立 了 一 个 对 话 框 ， 以 询问 用 户 是 否 可 以 关闭 窗口 (参见 
图 10-51 )。 如 果 用 户 不 同意 关闭 窗口 ， 那 么 该 窗口 仍旧 保持 打开 状态 。 

下 面 就 说 说 要 怎样 才能 实现 这 样 一 个 通知 机 制 。 

1 ) 为 每 个 框 体 添 加 一 个 监听 器 对 象 。 该 监听 器 对 象 必须 属于 实现 了 VetoableChangeListener 
接口 的 某 个 类 。 最 好 是 在 刚 构 建 完 这 个 框 体 时 就 添加 监听 器 。 在 我 们 的 示例 程序 中 ， 我 们 是 
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使 用 框 体 类 来 构建 内 部 框 体 的 。 另 外 一 种 选择 是 使 用 一 个 匿名 内 部 类 进行 构建 。 


iframe. addVetoableChangeListener (listener); 





图 10-51 用 户 可 以 否决 关闭 属性 


2) 实现 vetoableChange 方法 ， 该 方法 是 VetoableChangeListener 接口 唯一 要 求 
要 实现 的 方法 。 该 方法 接收 一 个 PropertyChangeEvent 对 象 ， 使 用 getName 方法 查找 将 
要 更 改 的 属性 的 名 称 ( 例 如， 如 果 该 方法 调用 要 否决 的 方法 是 setclosed(true)， 那 么 属 
性 名 就 是 “closed”)。 通 过 移 除 方法 名 的 “set ”前 级 ， 并 且 将 后 面 的 字母 变 为 小 写 ,， 便 
可 获得 属性 名 。 

3 ) 使 用 getNewValue 方法 获取 建议 使 用 的 新 值 。 


String name = event.getPropertyName() ; 
Object value = event.getNewValue() ; 
if (name.equals("closed") & value. equals(true)) 


ask user for confirmation 


4) 直接 通过 抛 出 一 个 PropertyVetoException 异常 来 阻止 属性 修改 。 如 果 不 想 否 决 
更 改 ， 则 正常 返回 。 


class DesktopFrame extends JFrame 
implements VetoableChangeListener 


public void vetoableChange(PropertyChangeEvent event) 
throws PropertyVetoException 
{ 


if (not ok) 
throw new PropertyVetoException(reason, event); 
// return normally if ok 
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4. 内 部 框 体 中 的 对 话 框 

如 果 使 用 内 部 框 体 ， 那 么 不 应 该 将 JDialog 类 用 作对 话 框 。 因 为 ， 这 些 对 话 框 有 两 个 
缺点 : 

e 它们 是 重量 级 的 ， 因 为 它们 是 在 窗口 系统 中 创建 了 一 个 新 的 框 体 。 

e 窗口 系统 并 不 知道 应 该 如 何 确定 这 些 对 话 框 与 派生 出 它们 的 内 部 框 体 之 间 的 相对 位 置 。 

相反 地 ， 对 于 简单 的 对 话 框 ， 请 使 用 JOptionPane 类 的 showInternalXxxDialog 方 
法 。 除 了 它们 是 在 内 部 框 体 上 放置 一 个 轻 量 级 窗口 外 ， 它 们 的 运行 特性 和 showXxxDialog 
方法 极为 相似 。 

对 于 更 复杂 的 对 话 框 ， 请 使 用 一 个 JInternalFrame 来 构建 。 遗 憾 的 是 ， 这 样 你 就 无 法 
使 用 任何 对 模式 对 话 框 的 内 置 文 持 了 。 

在 我 们 的 示例 程序 中 ， 我 们 使 用 了 一 个 内 部 对 话 框 ， 以 询问 用 户 是 否 可 以 关闭 某 个 
窗口 。 


int result = JOptionPane. showInternal Confi rmDialog( 
iframe, "OK to close?", "Select an Option", JOptionPane.YES_NO_OPTION) ; 


注意 : 如 果 只 是 想 在 关闭 一 个 框 体 时 能 够 得 到 通知 ， 那 么 就 应 该 不 使 用 否决 机 制 。 相 反 地 ， 
应 该 安装 一 个 InternalFrameListener 监听 器 。 内 部 框 体 监听 器 和 WindowListener 
监听 器 运行 特性 极为 相似 。 当 关闭 一 个 内 部 框 体 时 ， 调 用 的 是 internalFrameClosing 
方法 ， 而 不 是 大 家 所 熟悉 的 windowC1osing 方法 。 其 他 六 个 内 部 框 体 的 通知 (打开 / 关 
闭 ， 图 标 化 / 非 图 标 化 ， 激 活 / 钝 化 ) 也 对 应 于 窗口 监听 器 的 相应 方法 。 


5. 边框 拖 搜 

程序 开发 人 员 反 对 内 部 框 体 的 原因 之 一 是 : 它 的 性 能 不 是 很 好 。 最 缓慢 的 操作 就 是 在 果 
面 上 拖 搜 具有 复杂 内 容 的 框 体 。 在 拖 动 框 体 的 过 程 中 ， 桌 面 管理 器 会 不 断 要求 框 体重 新 绘 
制 ， 这 样 就 导致 其 速度 非常 缓慢 。 

实际 上 ， 如 果 使 用 的 Windows 或 者 X Windows 的 视频 驱动 程序 编写 得 比较 差 的 话 ， 你 
会 遇 到 同样 的 问题 。 在 大 多 数 系统 上 ， 窗 口 拖 动 的 运行 速度 看 起 来 都 很 快 ， 因 为 视频 硬件 文 
持 拖 动 操作 ， 在 拖 动 过 程 中 ， 可 以 将 框 体 中 的 图 像 映射 到 屏幕 别 的 位 置 上 。 

为 了 提高 性 能 ， 而 又 不 明显 损害 用 户 体验 ， 可 以 设置 “边框 拖 搜 ”。 当 用 户 拖 动 框 体 时 ， 
只 有 框 体 的 边框 是 连续 更 新 的 。 框 体 里 面 的 内 容 只 有 当 用 户 将 框 体 拖 动 到 它 的 最 终 停止 位 置 
上 的 时 候 才 会 刷新 。 

为 了 启动 边框 拖 动 ， 请 调用 

desktop. setDragMode(JDesktopPane.OUTLINE_DRAG_MODE) ; 


这 个 设置 等 价 于 JSp1itPane 类 的 “连续 布局 ”。 


注意 : 在 Swing 的 早期 版 本 中 ， 必 须 使 用 下 面 这 句 “ 魔 咒 ” 开 启 边框 拖 搜 : 
desktop. putClientProperty("JDesktopPane.dragMode", “outline”); 
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在 示例 程序 中 ， 可 以 使 用 Window 一 Drag Outline 复 选 框 菜单 选项 ， 来 开启 或 关闭 边框 
拖 搜 。 


GE] 注意 : 桌面 上 的 内 部 框 体 由 DesktopManager 类 负责 管理 ， 你 并 不 需要 知道 该 类 是 怎样 
用 于 常规 编程 的 。 通 过 安装 一 个 新 的 桌面 管理 器 ， 就 可 以 实现 不 同 的 桌面 行为 ， 不 过 我 
们 在 这 里 将 不 做 介绍 。 


在 程序 清单 10-31 的 桌面 中 能 人 了 一 个 用 于 显示 HTML 页 面 的 内 部 框 体 。 执行 
File 一 Open 菜单 选项 ,会 弹出 一 个 文件 对 话 框 用 于 将 一 个 本 地 HTML 文件 读 取 到 一 个 新 的 
内 部 框 体 中 。 如 果 点 击 了 任何 一 个 链接 ， 那 么 该 链接 文档 便 会 在 另外 一 个 内 部 框 体 中 显示 出 
来 。 请 试 运行 一 下 Window 一 Cascade 和 Window 一 Tile 命令 。 





package internalFrame; 


import java.awt.*; 
import java.beans.*; 


import javax. swing. *; 


/** 
* This desktop frame contains editor panes that show HTML documents. 
*/ 
public class DesktopFrame extends JFrame 
{ 
private static final int DEFAULT_WIDTH = 600; 
private static final int DEFAULT_HEIGHT = 400; 
15 private static final String[] planets = { "Mercury", "Venus", "Earth", "Mars", “Jupiter”, 
16 "Saturn", "Uranus", "Neptune", "Pluto", }; 


AD oo vi ED Nn A vv N e 


e e e e a 
> we N PH 5 


18 private JDesktopPane desktop; 
19 private int nextFrameX; 

20 private int nextFrameY; 

21 private int frameDi stance; 

22 private int counter; 


24 public DesktopFrame() 


25 { 

26 setSize(DEFAULT_WIDTH, DEFAULT_HEIGHT) ; 
27 

28 desktop = new JDesktopPane() ; 

29 add(desktop, BorderLayout.CENTER) ; 

30 

31 // set up menus 

32 

33 JMenuBar menuBar = new JMenuBar(); 

34 set)]MenuBar(menuBar) ; 

35 JMenu fileMenu = new JMenu("File'); 

36 menuBar.add(fi leMenu) ; 

37 JMenuItem openItem = new JMenultem("New") ; 











AAA 
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openItem.addActionListener(event -> 


createInternalFrame(new JLabel ( 
new ImageIcon(getClass() .getResource(planets[counter] + ".gif"))), 
planets [counter]) ; 

counter = (counter + 1) % planets. length; 


D 
fileMenu.add(openItem) ; 
JMenuItem exitItem = new JMenultem("Exit"); 
exitItem.addActionListener(event -> System.exit(0)); 
fileMenu.add(exitItem) ; 
JMenu windowMenu = new JMenu("Window") ; 
menuBar. add (windowMenu) ; 
JMenuItem nextItem = new JMenultem("Next") ; 
nextI tem. addActionListener(event -> selectNextWindow()) ; 
windowMenu. add(nextItem) ; 
JMenuItem cascadeItem = new JMenultem("Cascade") ; 
cascadeItem.addActionListener(event -> cascadeWindows()); 
windowMenu.add(cascadelItem) ; 
JMenuItem tileItem = new JMenuItem("Tile") ; 
tileItem.addActionListener(event -> tileWindows()); 
windowMenu. add(tileItem) ; 
final JCheckBoxMenuItem dragQutlineItem = new JCheckBoxMenultem("Drag Outline"); 
dragOut]ineItem.addActionListener(event -> 
desktop.setDragMode(dragOutlineItem.isSelected() ? JDesktopPane.QUTLINE_DRAG_MODE 
: JDesktopPane.LIVE_DRAG_MODE)) ; 
windowMenu. add(dragQut]ineItem) ; 


/** 
* Creates an internal frame on the desktop. 
* @param c the component to display in the internal frame 
* @param t the title of the internal frame 
| 


public void createInternalFrame(Component c, String t) 


final JInternalFrame iframe = new JInternalFrame(t, true, // resizable 
true, // closable 
true, // maximizable 
true); // iconifiable 


iframe.add(c, BorderLayout.CENTER) ; 
desktop.add(i frame) ; 


iframe.setFrameIcon(new ImageIcon(getClass() .getResource("document.gif"))); 


// add listener to confirm frame closing 
iframe. addVetoableChangeListener(event -> 


{ 
String name = event.getPropertyName() ; 
Object value = event.getNewValue() ; 


// we only want to check attempts to close a frame 
if (name.equals("closed") && value.equals(true)) 
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} 


// ask user if it is ok to close 


int result = JOptionPane.showInternalConfirmDialog(iframe, "OK to close?", 


"Select an Option", JOptionPane.YES_NO_OPTION) ; 


// if the user doesn't agree, veto the close 
if (result != JOptionPane.YES OPTION) 
throw new PropertyVetoException("User canceled close", event): 


// position frame 

int width = desktop.getWidthQ) / 2; 

int height = desktop.getHeight() / 2; 

iframe. reshape(nextFrameX, nextFrameY, width, height); 


iframe. show(); 
// select the frame--might be vetoed 
try 
{ 

iframe.setSelected(true) ; 
catch (PropertyVetoException ex) 
{ 
} 
FrameDistance = iframe.getHeight() - iframe.getContentPane() .getHeight(); 
// compute placement for next frame 
nextFrameX += frameDistance; 
nextFrameY += frameDistance; 


if (nextFrameX + width > desktop.getWidth()) nextFrameX = 0; 
if (nextFrameY + height > desktop.getHeight()) nextFrameY = 0; 


* Cascades the noniconified internal frames of the desktop. 


public void cascadeWindows () 


{ 


int x = 0; 
int y = 0; 
int width = desktop.getWidth() / 2; 
int height = desktop.getHeight() / 2; 
for (JInternalFrame frame : desktop.getAllFrames()) 
if (!frame.isIcon()) 
try 


// try to make maximized frames resizable; this might be vetoed 
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146 frame. setMaximum (fal se) ; 

147 frame. reshape(x, y, width, height); 

148 

149 x += frameDistance; 

150 y += frameDi stance; 

151 // wrap around at the desktop edge 

152 if (x + width > desktop.getWidth()) x = 0; 
153 if (y + height > desktop.getHeight()) y = 0; 
154 

155 catch (PropertyVetoException ex) 

156 

157 } 

158 } 

159 } 

160 } 

161 

12  /** 

163 * Tiles the noniconified internal frames of the desktop. 
164 */ 

165 public void tileWindows() 

6 { 

167 // count frames that aren't iconized 

168 int frameCount = 0; 

169 for (JInternalFrame frame : desktop.getAl]Frames()) 
170 if (!frame.isIcon()) frameCount++; 

171 if (frameCount == 0) return; 

172 

173 int rows = (int) Math.sqrt(frameCount) ; 

174 int cols = frameCount / rows; 

175 int extra = frameCount % rows; 

176 // number of columns with an extra row 

177 

178 int width = desktop.getWidth() / cols; 

179 int height = desktop.getHeight() / rows; 

180 int r = 0; 

181 int c = 0; 

182 for (JInternalFrame frame : desktop.getAl]Frames()) 
183 

184 if (!frame.isIcon()) 

185 { 

186 try 

187 { 

188 frame. setMaximum(false) ; 

189 frame. reshape(c * width, r * height, width, height); 
190 r++} 

191 if (r == rows) 

192 { 

193 r= 0: 

194 C++} 

195 if (c == cols - extra) 

196 

197 // start adding an extra row 

198 rows++} 


199 height = desktop.getHeight() / rows; 





610 Java ZSRR AT BAH 


200 } 
201 } 


203 catch (PropertyVetoException ex) 


211 * Brings the next noniconified internal frame to the front. 
212 */ 
213 public void selectNextWindow() 


215 JInternalFrame[] frames = desktop.getAl]Frames() ; 
216 for (int i = 0; i < frames.length; i++) 





{ 
218 if (frames[i].isSelected()) 


220 // find next frame that isn't an icon and can be selected 
221 int next = (i + 1) % frames. length; 
222 while (next != 7) 


224 if ('frames [next] .isIcon(Q) 


226 try 

227 { 

228 // all other frames are icons or veto selection 
229 frames [next] .setSelected(true) ; 

230 frames [next] ,toFront () ， 

231 frames [i] .toBack(); 

232 return; 

233 } | 
234 catch (PropertyVetoException ex) 3 
235 { 

236 } 


ES Sidhe okt he Pete, hae OA as 


237 
238 next = (next + 1) % frames. length; 





e JInternalFrame[] getAl1Frames() 


获取 该 桌面 面板 中 的 所 有 内 部 框 体 。 
e void setDragMode(int mode) 


将 拖 动 模式 设置 为 实况 拖 动 模式 或 边框 拖 动 模式 。 





#10 Ë BR Swing 611 


参数 : mode JDesktopPane.LIVE_DRAG_MODE, JDesktopPane.OUTLINE_ 
DRAG_MODE 其 中 之 一 





è JInternalFrame( ) 


e JInternalFrame(String title) 

e JInternalFrame(String title, boolean resizable) 

e JInternalFrame(String title, boolean resizable, boolean closable) 

e JInternalFrame(String title, boolean resizable, boolean closable, 
boolean maximizable) 

e JInternalFrame(String title, boolean resizable, boolean closable, 


boolean maximizable, boolean iconifiable) 


构建 一 个 新 的 内 部 框 体 。 


参数 : title 标题 栏 显示 的 字符 串 
resizable 如 果 该 框 体 可 放 缩 ， 则 为 true 
closable 如 果 框 体 可 以 关闭 ， 则 为 true 


maxmizable 如 果 该 框 体 可 以 最 大 化 ， 则 为 true 
iconifiable 如 果 该 框 体 可 以 图 标 化 ， 则 为 true 
e boolean isResizable() 
e void setResizable(boolean b) 
e boolean isClosable() 
e void setClosable(boolean b) 
e boolean isMaximizable() 
e void setMaximizable(boolean b) 
e boolean isIconifiable() 
e void setIconifiable(boolean b) 
获取 并 设置 属性 resizable, closable, maximizableL{& iconifiable, WRK 
属性 为 true， 那 么 在 框 体 的 标题 栏 处 会 显示 一 个 图 标 ， 用 于 缩放 、 关 闭 、 最 大 化 或 者 
图 标 化 该 内 部 框 体 。 
e boolean isIcon() 
e void setIcon(boolean b) 
e boolean isMaximum( ) 
e void setMaximum(boolean b) 
e boolean isClosed() 
e void setClosed(boolean b) 


获取 或 设置 icon, maximum 或 者 closed 属性 。 如 果 该 属性 为 true 那么 该 内 部 框 
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体 可 以 图 标 化 、 最 大 化 以 及 关闭 。 

e boolean isSelected( ) 

e void setSelected(boolean b) . 
获取 或 设置 selected 属性 。 如 果 该 属性 为 true， 那 么 当前 的 内 部 框 体 就 成 为 桌面 上 
被 选 定 的 框 体 。 

e void moveToFront() 

e void moveToBack( ) 

将 该 内 部 框 体 移 到 桌面 的 前 面 或 后 面 。 

e void reshape(int x, int y, int width, int height) 
移动 并 缩放 该 内 部 框 体 。 
参数 : x y 框 体 的 左上 角 

width, height 框 体 的 宽度 及 高 度 

e Container getCcontentPane( ) 

e void setContentPane(Container c) 
获取 并 设置 该 内 部 框 体 的 内 容 面板 。 

ə JDesktopPane getDesktopPane( ) 
获取 该 内 部 框 体 的 介面 面板 。 

è Icon getFrameIcon() 

e void setFrameIcon(Icon anIcon) 
获取 并 设置 显示 在 标题 栏 中 的 框 体 图 标 。 

e boolean isVisible() 

e void setVisible(boolean b) 
获取 并 设置 “可 见 ” 属 性 。 

evoid show() 


将 该 内 部 框 体 设 为 可 视 的 ， 并 将 它 移 到 前 面 。 





evoid addVetoableChangeListener(VetoableChangeListener listener) 


YSIN—TA ARE OU ae, SPAR ERIN, ORR EAE 





e void vetoableChange(PropertyChangeEvent event) 


当 受 约束 属性 的 set 方法 通知 可 否决 更 改 监 视 器 的 时 候 ， 调 用 该 方法 。 











e String getPropertyName( ) 
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返回 将 要 被 更 改 的 属性 的 名 称 。 
e Object getNewValue( ) 
返回 建议 用 于 该 属性 的 新 值 。 








e PropertyVetoException(String reason, PropertyChangeEvent event) 
构建 一 个 属性 否决 异常 。 
参数 : reason ”否决 的 原因 
event 被 否决 的 事件 


10.6.4 层 


Java SE 1.7 引 入 了 一 个 新 特性 ， 使 得 你 可 以 将 一 个 层 置 于 其 他 构件 之 上 。 你 可 以 在 层 上 
进行 绘制 ， 并 监听 其 底层 构件 的 事件 。 使 用 层 可 以 为 用 户 界面 添加 可 视 化 的 提示 线索 。 例 
如 ， 可 以 装饰 当前 的 输入 、 无 效 的 输入 或 禁用 的 构件 。 

JLayer 类 将 一 个 构件 与 某 个 LayerUI 对 象 关 联 在 一 起 ， 而 后 者 将 负责 绘制 和 事件 处 
SH, LayerUl 类 应 该 有 一 个 必须 与 所 关联 的 构件 相 匹配 的 类 型 参数 。 例 如 ， 下 面 的 代码 在 一 
4 JPanel 中 添加 了 一 个 层 : 


JPanel panel = new JPanel (0) ; 
LayerUI<JPanel> layerUI = new PanelLayer(); 
JLayer layer = new JLayer(panel, layerUI); 
frame. add (layer) ; 


注意 ， 这 段 代码 向 父 面板 添加 的 是 层 而 不 是 面板 ， 其 中 ，Pane1Layer 是 一 个 子 类 : 


class PanelLayer extends LayerUI<Panel> 


public void paint(Graphics g, JComponent c) 


} 
在 paint 方法 中 ， 可 以 绘制 任意 想 要 绘制 的 东西 ， 但 是 要 记 住 需要 调用 super.paint 
以 确保 构件 被 正确 绘制 。 这 里 ， 我 们 在 整个 构件 上 绘制 了 透明 的 颜色 : 


public void paint(Graphics g, JComponent c) 
{ 


Super.paint(g, c); 


Graphics2D g2 = (Graphics2D) g.create(); 

g2.setComposi te(AlphaComposi te. getInstance(AlphaComposite.SRC_OVER, .3f)); 
g2.setPaint(color)); 

g2.fillRect(0, 0, c.getWidth(), c.getHeight()); 

g2.dispose(); 
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为 了 监听 来 自 所 关联 构件 或 其 任意 儿子 构件 的 事件 ，LayerUI 类 必须 设置 层 事 件 掩 码 ， 
这 应 该 在 instal Ul 方法 中 完成 ， 就 像 下 面 这 样 : 


class PanelLayer extends LayerUI<JPanel> 


} 


public void installUI(JComponent c) 

Super. instal 1UI(c); 

((JLayer<?>) c).setLayerEventMask(AWTEvent.KEY_EVENT_MASK | AWTEvent.FOCUS_EVENT_MASK) ; 
public void uninstal1UI(JComponent c) 


((JLayer<?>) c).setLayerEventMask(0) ; 
super.uninstal1UI(c); 


} 


现在 就 可 以 在 名 为 processXxxEvent 的 方法 中 接收 事件 了 。 例 如 ， 在 我 们 的 示例 应 用 
中 ， 每 当 有 键盘 输入 时 ， 就 会 重 绘 层 : 


public class PanelLayer extends LayerUI<)Panel> 


} 


protected void processKeyEvent(KeyEvent e, JLayer<? extends JPanel> 1) 


{ 
].repaint(); 


} 


程序 清单 10-32 中 的 示例 程序 有 三 个 输入 框 ， 用 来 设置 颜色 的 RGB 值 。 无 论 何 时 ， 只 要 
用 户 改 变 了 这 些 值 ， 对 应 的 颜色 就 会 透明 地 显示 在 面板 上 。 我 们 还 捕获 了 焦点 事件 ， 并 以 粗 


体 字 显示 了 获得 焦点 的 构件 的 文本 。 





AD oo Nu en sm A u N e 


package layer; 


import java.awt.*; 

import java.awt.event.*; 
import javax.swing.*; 
import javax.swing.plaf.*; 


/** 

* A frame with three text fields to set the background color. 
gi 

public class ColorFrame extends JFrame 


{ 
private JPanel panel; 
private JTextField redField; 
private JTextField greenField; 
private JTextField blueField; 


public ColorFrame() 
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panel = new ]panel() ; 


panel.add(new JLabel ("Red:")); 
redField = new JTextField("255", 3); 
panel .add(redField) ; 


panel .add(new JLabel ("Green:")) ; 
greenField = new JTextField("255", 3); 
panel .add(greenField) ; 


panel .add(new JLabel ("Blue:")); 
blueField = new JTextField("255", 3); 
panel .add(blueField) ; 


LayerUI<JPanel> layerUI = new PanelLayer() ; 
JLayer<JPanel> layer = new JLayer<)Panel>(panel, layerUI); 


add (layer) ; 
pack() ; 


class PanelLayer extends LayerUI<)Panel> 


{ 


public void instal]UI(JComponent c) 

super. instal 1UI(c); 

((JLayer<?>) c).setLayerEventMask(AWTEvent.KEY_EVENT_MASK | AWTEvent. FOCUS_EVENT_MASK) ; 
public void uninstal1UI(JComponent c) 


((JLayer<?>) c).setLayerEventMask(0) ; 
super.uninstal 1UI(c) ; 


} 


protected void processKeyEvent (KeyEvent e, JLayer<? extends JPanel> 1) 


].repaint(); 


protected void processFocusEvent(FocusEvent e, JLayer<? extends JPanel> 1) 
if (e.getID() == FocusEvent.FOCUS_GAINED) 
{ 


Component c = e.getComponent () ; 
c.setFont (getFont () .deriveFont (Font.BOLD)) ; 


} 
if (e.getID() == FocusEvent.FOCUS_LOST) 
{ 


Component c = e.getComponent() ; 
c.setFont(getFont () .deriveFont (Font. PLAIN) ) ; 
} 
} 
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74 public void paint(Graphics g, JComponent c) 

75 { 

76 Super.paint(g, c); 

77 

78 Graphics2D g2 = (Graphics2D) g.create(); 

79 g2.setComposite(AlphaComposite.getInstance(AlphaComposite.SRC_OVER, .3f)); 
80 int red = Integer.parseInt(redField.getText() trim); 

81 int green = Integer. parseInt(greenField.getText().trim(); 
82 int blue = Integer.parseInt(blueField.getText().trim()); 
83 g2.setPaint(new Color(red, green, blue)); 

84 g2.fillRect(0, 0, c.getWidth(), c.getHeight()); 

85 g2.dispose(); 

86 } 

87 } 

88 } 





e JLayer(V view, LayerUI<V> ui) 
构建 在 给 定 视 图 之 上 的 层 ， 将 绘制 和 事件 处 理 职责 代理 给 ui 对 象 。 

e void setLayerEventMask( long 1ayerEventMask ) 
开局 所 有 匹配 事件 的 发 送 机 制 ， 将 所 有 发 送 给 所 关联 的 构件 或 其 任意 子孙 构件 的 事 
件 发 送 给 相关 联 的 LayerUI。 对 于 事件 掩 码 ， 可 以 组 合 AWTWEvent 类 中 的 以 下 任意 


常量 : 

COMPONENT_EVENT_MASK KEY_EVENT_MASK 
FOCUS_EVENT_MASK MOUSE_EVENT_MASK 
HIERARCHY_BOUNDS_EVENT_MASK MOUSE_MOTION_EVENT_MASK 
HIERARCHY_EVENT_MASK MOUSE_WHEEL_EVENT_MASK 


INPUT_METHOD_EVENT_MASK 





e void install1UI(JComponent c) 


e void uninstal1UI(JComponent c) 
当 为 构件 c 安装 或 印 载 LayerUI 时 调用 。 和 覆盖 该 方法 时 ， 应 该 设置 或 清除 层 事 件 
HEA 
e void paint(Graphics g, JComponent c) 
当 装 饰 的 构件 被 绘制 时 调用 。 和 覆盖 该 方法 时 ， 应 该 调用 super .paint 并 绘制 各 种 
RMN o 
e void processComponentEvent(ComponentEvent e, JLayer<? extends V> 1) 
e void processFocusEvent(FocusEvent e, JLayer<? extends V> 1) 
e void processHierarchyBoundsEvent(HierarchyEvent e, JLayer<? extends V> 1) 


e void processHierarchyEvent(HierarchyEvent e, JLayer<? extends V> 1) 
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e void processInputMethodEvent(InputMethodEvent e, JLayer<? extends V> 1) 

e void processKeyEvent(KeyEvent e, JLayer<? extends V> 1) 

ə void processMouseEvent(MouseEvent e, JLayer<? extends V> 1) 

e void processMouseMotionEvent(MouseEvent e, JLayer<? extends V> 1) 

e void processMouseWheelEvent(MouseWheelEvent e, JLayer<? extends V> 1) 

当 指定 事件 发 送 到 该 LayerUI 时 被 调用 。 

你 已 经 看 到 了 可 以 如 何 使 用 Swing 框架 提供 的 复杂 构件 。 在 下 一 章 ， 我 们 将 转 癌 AWT 

相关 的 话题 : 复杂 的 绘制 操作 、 图 像 处 理 、 打 印 机 制 以 及 与 本 地 窗口 系统 的 接口 机 制 等 。 





第 11 草 局 级 AWT 


A 绘图 操作 流程 A 绘图 提示 

全 形状 A ARRAS Ad 
A 区 域 A 图 像 处 理 

全 笔划 A 打印 

全 着 色 全 前 贴 板 

全 坐标 变换 A 拖 放 操作 

A BY A 平台 集成 

A 


透明 与 组 合 


Graphics 类 有 多 种 方法 可 以 用 来 创建 简单 的 图 形 。 这 些 方 法 对 于 简单 的 applet 和 应 用 
来 说 已 经 绰绰有余 了 ， 但 是 当 你 创建 复杂 的 图 形 或 者 需要 全 面 控制 图 形 的 外 观 时 ， 它 们 就 显 
得 力不从心 了 。Java 2D API 是 一 个 更 加 成 熟 的 类 库 ， 可 以 用 它 产生 高 质量 的 图 形 。 本 章 中 ， 
我 们 将 概要 地 介绍 一 下 该 API. 

然后 我 们 将 要 讲述 关于 打印 方面 的 问题 ， 说 明 如 何 将 打印 功能 纳入 到 程序 之 中 。 


最 后 ， 我 们 将 介绍 在 程序 间 传 递 数据 的 两 种 方法 : 系统 剪 切 板 和 拖 放 机 制 。 可 以 使 用 这 


些 技术 在 两 个 Java 应 用 之 间 ， 或 者 在 Java 应 用 和 本 机 程序 之 间 传递 数据 。 最 后 ， 我 们 将 讨 
论 使 Java 应 用 用 起 来 就 像 本 地 应 用 一 样 的 技术 ， 例 如 提供 闪 屏 和 在 系统 托盘 中 的 图 标 。 


11.1 ”绘图 操作 流程 


在 最 初 的 JDK 1.0 中 ， 用 来 绘制 形状 的 是 一 种 非常 简单 的 机 制 ， 即 选择 颜色 和 画图 的 模 
式 ， 并 调用 Graphics 类 的 各 种 方法 ， 比 如 drawRect 或 者 fi110va1。 而 Java2D API 支 持 
更 多 的 功能 : 

o 可 以 很 容易 地 绘制 各 式 各 样 的 形状 。 

e 可 以 控制 绘制 形状 的 笔划 ， 即 控制 跟踪 形状 边界 的 绘图 笔 。 

e 可 以 用 音色 、 变 化 的 色调 和 重复 的 模式 来 填充 各 种 形状 。 

o 可 以 使 用 变换 法 ， 对 各 种 形状 进行 移动 、 缩 放 、 旋 转 和 拉 伸 。 

o 可 以 对 形状 进行 剪 切 ， 将 其 限制 在 任意 的 区 域内 。 

o 可 以 选择 各 种 组 合 规则 ， 来 描述 如 何 将 新 形状 的 像素 与 现 有 的 像素 组 合 起 来 。 

o 可 以 提供 绘制 图 形 提示 ， 以 便 在 速度 与 绘图 质量 之 间 实 现 平衡 。 

如 果 要 绘制 一 个 形状 ， 可 以 按照 如 下 步骤 操作 
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1 ) 获得 一 个 Graphics2D 类 的 对 象 ， 该 类 是 Graphics 类 的 子 类 。 自 Java SE 1.2 WK, 
paint 和 paintComponent 等 方法 就 能 够 自动 地 接收 一 个 Graphics2D 类 的 对 象 ， 这 时 可 
以 直接 使 用 如 下 的 转型 : 


public void paintComponent (Graphics g) 
{ 
Graphics2D g2 = (Graphics2D) g; 


} 
2) 使 用 setRenderingHints 方法 来 设置 绘图 提示 ， 它 提供 了 速度 与 绘图 质量 之 间 的 
一 种 平衡 。 


RenderingHints hints =.. .; 
g2.setRenderinghints (hints) ; 


3) 使 用 setStroke 方 法 来 设置 笔划 ， 笔 划 用 于 绘制 形状 的 边框 。 可 以 选择 边框 的 粗细 
和 线段 的 虚实 。 


Stroke stroke = ，，,; 
g2.setStroke(stroke) ; 


4) 使 用 setPaint 方法 来 设置 着 色 法 ， 着 色 法 用 于 填充 诸如 笔划 路 径 或 者 形状 内 部 等 
区 域 的 颜色 。 可 以 创建 单 色 、 渐 变色 或 者 平 铺 的 填充 模式 。 


Paint paint=.. .; 
g2.setPaint (paint) ; 


5) 使 用 clip 方法 来 设置 剪 切 区 域 。 


Shape Clip = ，，,; 
g2.clip(clip); 


6) 使 用 transform 方 法 设置 一 个 从 用 户 空 间 到 设备 空间 的 变换 方式 。 如 果 使 用 变换 廊 
式 比 使 用 像素 坐标 更 容易 定义 在 定制 坐标 系统 中 的 形状 ， 那么 就 可 以 使 用 变换 方式 。 


AffineTransform transform=... 
g2.transform(transform) ; 


7) 使 用 setComposite 方法 设置 一 个 组 合 规则 ， 用 来 描述 如 何 将 新 像素 与 现 有 的 像素 
组 合 起 来 。 


Composite composite =.. .; 
g2.setComposi te (composite) ; 


8 ) 建立 一 个 形状 ，Java 2D API 提供 了 用 来 组 合 各 种 形状 的 许多 形状 对 象 和 方法 。 

Shape shape=.. .; 

9 ) 绘制 或 者 填充 该 形状 。 如 果 要 绘制 该 形状 ， 那 么 它 的 边框 就 会 用 笔划 画 出 来 。 如 采 
要 填充 该 形状 ， 那 么 它 的 内 部 就 会 被 着 色 。 


g2.draw(shape) ; 
g2.fi11 (shape) ; 


当然 ， 在 许多 实际 的 环境 中 ， 并 不 需要 采用 所 有 这 些 操 作 步 又。Java 2D 图 形 上 下 文中 
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有 合理 的 默认 设置 。 只 有 当 你 确实 想 要 改变 设置 时 ， 再 去 修改 这 些 默 认 设置 。 
在 下 面 的 几 节 中 ， 我 们 将 要 介绍 如 何 描绘 形状 、 笔 划 、 着 色 、 变 换 及 组 合 的 规则 。 
各 种 不 同 的 set 方法 只 是 用 于 设置 2D 图 形 上 下 文 的 状态 ， 它 们 并 不 进行 任何 实际 的 
绘图 操作 。 同 样 ， 在 构建 shape 对 象 时 ， 也 不 进行 任何 绘图 操作 。 只 有 在 调用 draw 或 者 
fill 方法 时 ， 才 会 绘制 出 图 形 的 形状 ， 而 就 在 此 刻 ， 这 个 新 的 图 形 由 绘图 操作 流程 计算 出 
来 (参见 图 11-1 )。 





图 11-1 绘图 操作 流程 


在 绘图 流程 中 ， 需 要 以 下 这 些 操作 步骤 来 绘制 一 个 形状 : 

1 ) 用 笔划 画 出 形状 的 线条 ; 

2 ) 对 形状 进行 变换 操作 ; 

3) 对 形状 进行 剪 切 。 如 果 形 状 与 剪 切 区 域 之 间 没 有 任何 相交 的 地 方 ， 那 么 就 不 用 执行 
该 操作 ; 

4) 对 前 切 后 的 形状 进行 填充 ; 

5 ) 把 填充 后 的 形状 与 已 有 的 形状 进行 组 合 (在 图 11-1 中 ， 圆 形 是 已 有 像素 部 分 ， 杯 子 
的 形状 加 在 了 它 的 上 面 )。 

在 下 一 节 中 ， 将 会 讲述 如 何 对 形状 进行 定义 。 然 后 ， 我 们 将 转 而 对 2D 图 形 上 下 文 设置 
进行 介绍 。 





e void draw(Shape s) 

用 当前 的 笔划 来 绘制 给 定形 状 的 边框 。 
evoid fill(Shape s) 

用 当前 的 着 色 方 案 来 填充 给 定形 状 的 内 部 。 


11.2 ”形状 


下 面 是 Graphics 类 中 绘制 形状 的 若干 方法 : 


drawLine 
drawRectangle 
drawRoundRect 
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draw3DRect 
drawPolygon 
drawPolyline 
draw0val 
drawArc 


它们 还 有 对 应 的 F111 方法 ， 这 些 方法 从 JDK 1.0 起 就 被 纳入 到 Graphics 类 中 了 。Java 2D 
API 使 用 了 一 套 完 全 不 同 的 面向 对 象 的 处 理 方法 ， 即 不 再 使 用 方法 ， 而 是 使 用 下 面 的 这 些 类 : 


Line2D 
Rectangle2D 
RoundRectang] e2D 
Ellipse2D 

Arc2D 
QuadCurve2D 

Cubi cCurve2D 
General Path 


这 些 类 全 部 都 实现 了 Shape 接口 ， 我 们 将 在 下 面 各 小 节 中 一 一 审视 它们 。 


11.2.1 形状 类 层次 结构 


Line2D, Rectangle2D, RoundRectangle2D, Ellipse2D 和 Arc2D 等 这 些 类 对 应 
于 drawLine, drawRectangle, drawRoundRect, drawOval 和 drawArc 等 方法 。( “3D 
矩形 ”的 概念 已 经 理所当然 地 过 时 了 ， 因 而 没有 与 draw3DRect 方法 相对 应 的 类 。) Java 2D 
API 提供 了 两 个 补充 类 ， 即 二 次 曲线 类 和 三 次 曲线 类 。 我 们 将 在 本 节 的 后 面部 分 阐释 这 些 形 
状 。Java 2D API 中 没有 任何 Polygon2D 类 。 相 反 ,， 它 用 GeneralPath 类 来 描述 由 线条 、 
二 次 曲线 、 三 次 曲线 构成 的 线条 路 径 。 可 以 使 用 GeneralPath 来 描述 一 个 多 边 形 ; 我 们 将 
在 本 节 的 后 面部 分 对 它 进 行 介绍 。 

如 果 要 绘制 一 个 形状 ， 首 先 要 创建 一 个 实现 了 Shape 接口 的 类 的 对 象 ， 然 后 调用 
Graphics2D 类 的 draw 方法 。 

下 面 这 些 类 :; 


Rectang] e2D 
RoundRectang] e2D 
Ellipse2D 

Arc2D 


都 是 从 一 个 公共 超 类 RectangularShape 4AM RN. WA, PAIL MIE AB A EE 
形 ， 但 是 它们 都 有 一 个 矩形 的 边界 框 〈 人 参见 图 11-2 )。 

名 字 以 “2D” 结 尾 的 每 个 类 都 有 两 个 
子 类 ， 用 于 指定 坐标 是 float 类 型 的 还 
是 double 类 型 的 。 在 本 书 的 卷 I 中， 我 
们 已 经 介绍 了 Rectangle2D.Fl1oat 和 
Rectangle2D.Double, 

其 他 类 也 使 用 了 相同 的 模式 ， 比 如 
Arc2D.Float All Arc2D.Double, 
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从 内 部 来 讲 ， 所 有 的 图 形 类 使 用 的 都 是 Float 类 型 的 坐标 ， 因 为 float 类 型 的 数 占用 
较 少 的 存储 空间 ， 而 且 它 们 有 足够 高 的 几何 计算 精度 。 然 而 ，Java 编程 语言 使 得 对 Float 类 
型 的 数 的 操作 要 稍微 复杂 些 。 由 于 这 个 原因 ， 图 形 类 的 大 多 数 方法 使 用 的 都 是 double 类 型 
的 参数 和 返回 值 。 只 有 在 创建 一 个 2D 对 象 的 时 候 ， 才 需要 选择 究竟 是 使 用 带 有 float 类 型 
坐标 的 构造 器 ， 还 是 使 用 带 有 double 类 型 坐标 的 构造 器 。 例 如 ， 


Rectangle2D floatRect = new Rectangle2D.Float(5F, 10F, 7.5F, 15F); 
Rectangle2D doubleRect = new Rectangle2D.Double(5, 10, 7.5, 15); 


Xxx2D.Float 和 Xxx2D .Double 两 个 类 都 是 Xxx2D 类 的 子 类 ， 在 对 象 被 构建 之 后 ， 再 
记 住 其 确切 的 子 类 型 实质 上 已 经 没有 任何 额外 的 好 处 了 ， 因 此 可 以 将 刚 被 构建 的 对 象 存储 为 
一 个 超 类 变量 ， 正 如 上 面 代码 示例 中 所 阐释 的 那样 。 

从 这 些 类 古怪 的 名 字 中 就 可 以 判断 出 ，Xxx2D .Float 和 Xxx2D .Double 两 个 类 同时 也 
是 Xxx2D 类 的 内 部 类 。 这 只 是 为 了 在 语法 上 比较 方便 ， 以 避免 外 部 类 的 名 字 变 得 太 长 。 

最 后 ， 还 有 一 个 Point2D 类 ， 它 用 x Aly 坐标 来 描述 一 个 点 。 点 对 于 定义 形状 非常 有 
用 ， 不 过 它们 本 身 并 不 是 形状 。 

图 11-3 显示 了 各 个 形状 类 之 间 的 关系 。 不 过 图 中 省 略 了 Double 和 Float 子 类 ， 并 且 
来 目 以 前 的 2D 类 库 的 遗留 类 用 灰色 的 填充 色 标 识 。 
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图 11-3 ”形状 类 之 间 的 关系 
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11.2.2 ”使 用 形状 类 


我 们 在 本 书 的 卷 工 第 10 章 中 介绍 了 如 何 使 用 Rectangle2D, Ellipse2D 和 Line2D 类 
的 方法 。 本 节 将 介绍 如 何 建立 其 他 的 2D 形状 。 

如 果 要 建立 一 个 RoundRectang1le2D 形状 ， 应 该 设 定 左上 和 角 、 宽 度 、 高 度 及 应 该 变 成 
圆 角 的 边 角 区 的 x 和 y 的 坐标 尺寸 (参见 图 11-4 ) 。 例 如 ， 调 用 下 面 的 方法 : 

RoundRectangle2D r = new RoundRectangle2D.Double(150, 200, 100, 50, 20, 20); 


便 产生 了 一 个 带 圆 角 的 矩形 ， 每 个 角 的 圆 半径 为 20。 





和 


图 11-4 构建 一 个 RoundRectangle2D 


如 果 要 建立 一 个 弧 形 ， 首 先 应 该 设 定 边界 框 ， 接 着 设 定 它 的 起 始 角 度 和 弧 形 跨 越 的 角度 
( 见 图 11-5)， 并 且 设 定 弧 形 闭合 的 类 型 ， 即 Arc2D.OPEN, Arc2D.PIE 或 者 Arc2D.CHORD 
这 几 种 类 型 中 的 一 个 。 


Arc2D a = new Arc2D(x, y, width, height, startAngle, arcAngle, closureType) ; 
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图 11-6 显示 了 几 种 弧 形 的 类 型 。 
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KI 11-6 ” 弧 形 的 类 型 


O 警告 .如果 弧 形 是 椭圆 的 ， 那 么 弧 形 角 的 计算 就 不 是 很 直接 了 。API 文档 中 描述 到 :“ 角 
是 相对 于 非 正方 形 的 短 形 边框 指定 的 ， 以 使 得 45 度 总 是 落 到 了 从 椭圆 中 心 指向 矩形 边框 
右上 角 的 方 和 向上。 因此， 如果 纸 形 边框 的 一 条 轴 比 另 一 条 轴 明 显 长 许多 ， 那 么 弧 形 段 的 
起 始点 和 终止 点 就 会 与 边框 中 的 长 轴 斜 交 。” 但 是 ,文档 中 并 没有 说 明 如 何 计 算 这 种 “ 斜 
交 ”。 下 面 是 其 细节 ， 

假设 弧 形 的 中 心 是 原点 ,而且 点 (xy) 在 缴 形 上 。 那 么 我 们 可 以 用 下 面 的 公式 来 获 
得 这 个 斜 交角 : 

skewedAngle = Math.toDegrees(Math.atan2(-y * height, x * width)); 
这 个 值 介 于 一 180 到 180 之 间 。 按 照 这 种 方式 计算 斜 交 的 起 始 角 和 终止 角 ， 然 后 ， 计 算 两 
个 斜 交角 之 间 的 差 ， se a 之 后 ， 将 起 始 角 和 角 的 
差 提供 给 弧 形 的 构造 器 。 如 果 运 行 本 节 末 尾 的 程序 ， 你 用 肉眼 就 能 观察 到 这 种 计算 所 产 
生 的 用 于 弧 形 构造 器 的 值 是 正确 的 。 可 参见 本 章 图 11-9, 


Java 2D API 提供 了 对 二 次 曲线 和 三 次 曲线 的 支持 。 在 本 章 中 ， 我 们 并 不 会 深入 介绍 这 些 
曲线 的 数学 特征 。 我 们 建议 你 通过 运行 程序 清单 11-1 的 代码 ， 对 曲线 的 形状 有 一 个 感性 的 认 
识 。 正 如 在 图 11-7 和 图 11-8 中 看 到 的 那样 ， 二 次 曲线 和 三 次 曲线 是 由 两 个 端点 和 一 个 或 两 
个 控制 点 来 设 定 的 。 移 动 控制 点 ， 曲 线 的 形状 就 会 改变 。 
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如 果 要 构建 二 次 曲线 和 三 次 曲线 ， 需 要 给 出 两 个 端点 和 控制 点 的 坐标 。 例 如 ， 


QuadCurve2D q = new QuadCurve2D.Double(startX, startY, controlX, controlY, endX, endY); 
CubicCurve2D c = new CubicCurve2D.Double(startX, startY, control1X, control1Y, 
control2X, control2Y, endX, endY); 


二 次 曲线 不 是 非常 灵活 ， 所 以 实际 上 它 并 不 常用 。 三 次 曲线 (比如 用 CubicCurve2D 类 
绘制 的 贝 塞 尔 (Btzier) 曲线 ) 却 是 非常 常用 的 。 通 过 将 三 次 曲线 组 合 起 来 ， 使 得 连接 点 的 
各 个 斜率 互相 匹配 ， 就 能 够 创建 复杂 的 、 外 观 平 滑 的 曲线 形状 。 如 果 要 了 解 这 方面 的 详细 信 
息 ， 请 参阅 James D. Foley, Andries van Dam 和 Steven K. Feiner 等 人 合作 撰写 的 《 Computer 
Graphics: Principles and Practice ) °| Addison Wesley 出 版 社 1995 年 出 版 。 
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图 11-7 二 次 曲线 图 11-8 三 次 曲线 


可 以 建立 线段 、 二 次 曲线 和 三 次 曲线 的 任意 序列 ， 并 把 它们 存放 到 一 个 GeneralPath 
对 象 中 去 。 可 以 用 moveTo 方法 来 指定 路 径 的 第 一 个 坐标 ， 例 如 ， 


GeneralPath path = new Ceneralpath() ; 
path.moveTo(10, 20); 


然后 ， 可 以 通过 调用 lineTo, quadTo  curveTo 三 种 方法 之 一 来 扩展 路 径 ， 这 些 方 
法 分 别 用 线条 、 二 次 曲线 或 者 三 次 曲线 来 扩展 路 径 。 如 果 要 调用 1ineTo 方法 ， 需 要 提供 它 
的 端点 。 而 对 两 个 曲线 方法 的 调用 ， 应 该 先 提供 控制 点 ， 然 后 提供 端点 。 例 如 ， 


path. lineTo(20, 30); 
path.curveTo(control1X, control1Y, control2X, control2Y, endX, endY); 


可 以 调用 closePath 方法 来 闭合 路 径 ， 它 能 够 绘制 一 条 回 到 路 径 起 始点 的 线条 。 

如 果 要 绘制 一 个 多 边 形 ， 只 需 调 用 moveTo 方法 ， 以 到 达 第 一 个 拐角 点 ， 然 后 反复 调用 
1ineTo 方法 ， 以 便 到 达 其 他 的 拐角 点 。 最 后 调用 closePath 方法 来 闭合 多 边 形 。 程 序 清单 
11-1 更 加 详细 地 展示 了 构建 多 边 形 的 方法 。 

普通 路 径 没有 必要 一 定 要 连接 在 一 起 ， 我 们 随时 可 以 调用 moveTo 方法 来 建立 一 个 新 的 


最 后 ， 可 以 使 用 append 方法 ， 向 普通 路 径 添加 任意 个 Shape 对 象 。 如 果 新 建 的 形状 应 


”本 书 的 中 文 版 以 及 英文 影印 版 已 由 机 械 工业 出 版 社 出 版 。 中 文 版 书 名 为 《计算 机 图 形 学 原理 及 实践 》 书号 
为 : 7-111-13026-X， 英 文 影印 版 书号 为 7-111-10343-2。 一 一 编辑 注 
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该 连接 到 路 径 的 最 后 一 个 端点 ， 那 么 append 方法 的 第 二 个 参数 值 就 是 true， 如 果 不 应 该 连 
接 ， 那 么 该 参数 值 就 是 false。 例 如 ,调用 下 面 的 方法 : 


Rectangle2D r=.. 
path.append(r, false); 


可 以 把 矩形 的 边框 添加 到 该 路 径 中 ,但 并 不 与 现 有 的 路 径 连接 在 一 起 。 而 下 面 的 方法 调用 : 
path.append(r, true); 


WU Fe FE AE AY A ATE KHERA I TRB, IG AO HER BK t, 

程序 清单 11-1 中 的 程序 使 你 能 够 构建 许多 示例 路 径 。 图 11-7 和 图 11-8 显示 了 运行 该 程序 的 
示例 结果 。 你 可 以 从 组 合 框 中 选择 一 个 形状 绘制 器 ， 该 程序 包含 的 形状 绘制 器 可 以 用 来 绘制 

e 直线 ; 

o 和 矩形、 圆 角 矩 形 和 椭圆 形 ; 

e 浙 形 《除了 显示 弧 形 本 身 外 ， 还 可 以 显示 和 撼 形 边 框 的 线条 和 起 始 角度 及 结束 角度 ); 

o 多 边 形 (使 用 GeneralPath 方法 ); 

e 二 次 曲线 和 三 次 曲线 。 

可 以 用 鼠标 来 调整 控制 点 。 当 你 移动 控制 点 时 ， 形 状 会 连续 地 重 绘 。 

该 程序 有 些 复杂 ， 因 为 它 可 以 用 来 处 理 多 种 不 同 的 形状 ， 并 且 支 持 对 控制 点 的 拖 搜 操作 。 

HAMA ShapeMaker 封装 了 形状 绘制 器 类 的 共性 特征 。 每 个 形状 都 拥有 固定 数量 的 控 
制 点 ， 用 户 可 以 在 控制 点 周围 随意 移动 ， 而 getPointCount 方法 用 于 返回 控制 点 的 数量 。 
下 面 这 个 抽象 方法 : 

Shape makeShape(Point2D[] points) 

将 在 给 定 控制 点 的 当前 位 置 的 情况 下 ， 计 算 实际 的 形状 。tostring 方法 用 于 返回 类 的 
名 字 ， 这 样 ，ShapeMaker 对 象 就 能 够 放置 到 一 个 JComboBox 中 

为 了 激活 控制 点 的 拖 搜 特征 ，ShapePane1 类 要 同时 
处 理 鼠 标 事 件 和 鼠标 移动 事件 。 当 鼠标 在 一 个 矩形 上 面 被 
按 下 时 ， 那 么 拖 搜 鼠标 就 可 以 移动 该 矩形 了 。 

大 部 分 形状 绘制 器 类 都 很 简单 ， 它 们 的 makeShape 
方法 只 是 用 于 构建 和 返回 需要 的 形状 。 然 而 ， 当 使 用 
ArcMaker 类 的 时 候 ， 需 要 计算 弧 形 的 变形 起 始 角 度 和 
结束 角度 。 此 外 ,为 了 说 明 这 些 计 算 确 实 是 正确 的 ， 返 ore - 
回 的 形状 应 该 是 包含 该 弧 本 身 、 和 矩形 边框 和 从 弧 形 中 | 
心 到 角度 控制 点 之 间 的 线条 等 的 GeneralPath (参见 
图 11-9 )。 





图 11-9 ShapeTest 程序 的 运行 结果 





1 package shape; 
2 
3 Import java.awt.*; 
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4 import java.awt.event.*; 
5 import java.awt.geom.*; 

6 import java.util.*; 

7 import javax.swing.*; 

8 

9 /** 

10 * This program demonstrates the various 2D shapes. 


11 * @version 1.03 2016-05-10 
12 * @author Cay Horstmann 


3 */ 

14 public class ShapeTest 

15 { 

16 public static void main(String[] args) 

17 { 

18 EventQueue.invokeLater(() -> 

19 

20 JFrame frame = new ShapeTestFrame() ; 

21 frame.setTitle("ShapeTest’) ; 

22 frame. setDefaul tCloseOperation(JFrame.EXIT_ON_CLOSE) ; 
23 frame. setVisible(true) ; 

24 }); 

25 } 

26 } 

27 

28 /** 

29 * This frame contains a combo box to select a shape and a component to draw it. 
0 */ 


31 class ShapeTestFrame extends JFrame 


33 public ShapeTestFrame() 


34 { 

35 final ShapeComponent comp = new ShapeComponent () ; 

36 add(comp, BorderLayout. CENTER) ; 

37 final JComboBox<ShapeMaker> comboBox = new JComboBox<>() ; 
38 comboBox.addItem(new LineMaker()); 

39 comboBox.addItem(new Rectang] eMaker()) ; 

40 comboBox.addItem(new RoundRectang] eMaker()) ; 

41 comboBox.addItem(new EllipseMaker()); 

42 comboBox.addItem(new ArcMaker()); 

43 comboBox.addItem(new PolygonMaker()) ; 

44 comboBox.addItem(new QuadCurveMaker()) ; 

45 comboBox.addItem(new CubicCurveMaker()) ; 

46 comboBox.addActionListener(event -> 

47 { 

48 ShapeMaker shapeMaker = comboBox.getItemAt (comboBox.getSel ectedIndex()) ; 
49 comp. setShapeMaker(shapeMaker) ; 

50 }); 

51 add(comboBox, BorderLayout.NORTH) ; 

52 comp.setShapeMaker((ShapeMaker) comboBox.getItemAt(0)) ; 
53 pack(); 

54 } 

so} 

56 

57 /** 


s8 * This component draws a shape and allows the user to move the points that define it. 
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class ShapeComponent extends JComponent 


private static final Dimension PREFERRED_SIZE = new Dimension(300, 200); 
private Point2D[] points; 

private static Random generator = new Random(); 

private static int SIZE = 10; 

private int current; 

private ShapeMaker shapeMaker; 


public ShapeComponent () 
{ 
addMouseListener(new MouseAdapter() 


public void mousePressed(MouseEvent event) 
{ 
Point p = event.getPoint(); 
for (int 1 = 0; 1 < points.length; i++) 
{ 
double x = points[i].getX() - SIZE / 2; 
double y = points[i].getY() - SIZE / 2; 
Rectangle2D r = new Rectangle2D.Double(x, y, SIZE, SIZE); 
if (r.contains(p)) 
{ 


current = 1; 
return; 
} 
} 
} 
public void mouseReleased(MouseEvent event) 
{ 
current = -1; 
} 


}); 


addMouseMotionListener(new MouseMotionAdapter() 


public void mouseDragged(MouseEvent event) 
{ 
if (current == -1) return; 
points(current] = event.getPoint(); 
repaint(); 
} 
D: 


current = -1; 


/** 
* Set a shape maker and initialize it with a random point set. 


* @param aShapeMaker a shape maker that defines a shape from a point set 
* 


public void setShapeMaker(ShapeMaker aShapeMaker) 
{ 


ShapeMaker = aShapeMaker; 
int n = shapeMaker.getPointCount() ; 
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} 


/** 
* A shape maker can make a shape from a point set. Concrete subclasses must return a shape in the 
* makeShape method. 
* 
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points = new Point2D[n] ; 

for (int 1 = 0; 1 < n; i++) 

{ 
double x = generator.nextDouble() * getWidth(); 
double y = generator.nextDouble() * getHeight() ; 
points[i] = new Point2D.Double(x, y); 


repaint(); 
} 
public void paintComponent (Graphics g) 
{ 
if (points == null) return; 
Graphics2D g2 = (Graphics2D) g; 
for (int i = 0; i < points.length; i++) 
double x = points[i].getX() - SIZE / 2; 
double y = points[i].getY() - SIZE / 2; 
g2.fill(new Rectangle2D.Double(x, y, SIZE, SIZE)); 
} 
g2.draw(shapeMaker.makeShape(points)) ; 
} 


public Dimension getPreferredSize() { return PREFERRED_SIZE; } 


abstract class ShapeMaker 


{ 


private int pointCount; 


/** 
* Constructs a shape maker. 


* @param pointCount the number of points needed to define this shape. 
* 


public ShapeMaker(int pointCount) 


this.pointCount = pointCount; 


} 


/** 
* Gets the number of points needed to define this shape. 
* @return the point count 
af 

public int getPointCount() 

{ 


} 
/** 


return pointCount; 
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168 * Makes a shape out of the given point set. 
169 * @param p the points that define the shape 
170 * @return the shape defined by the points 
171 */ 
7 public abstract Shape makeShape(Point2D[] p); 
173 
74 public String toString) 
175 
176 return getClass() .getName() ; 
17 } 
178 } 
179 
180 /** 
181 * Makes a line that joins two given points. 
w +y 
183 Class LineMaker extends ShapeMaker 
184 { 
185 public LineMaker() 
{ 


_ 


ro 





187 super (2) ; 

188 } 

189 

190 public Shape makeShape(Point2D[] p) 


191 { 

192 return new Line2D.Double(p[0], p[1]); 
193  } 

194 } 

195 

196 /** 

197 * Makes a rectangle that joins two given corner points. 
198 */ 

199 Class RectangleMaker extends ShapeMaker 

200 { 

201 public RectangleMaker() 

202 | 

203 Super (2); 

204 } 


205 
206 public Shape makeShape(Point2D[] p) 


27 { 

208 Rectangle2D s = new Rectangle2D.Double(); 
209 s.setFrameFromDi agonal (p[0], p[1]); 

210 return sS; 

m1 } 

212 } 

213 

214 /** 

215 * Makes a round rectangle that joins two given corner points. 
216 */ 

217 Class RoundRectangleMaker extends ShapeMaker 
218 { 


219 public RoundRectang] eMaker() 
220 
221 Super(2); 
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22 ë } 
224 public Shape makeShape(Point2D[] p) 


{ 
226 RoundRectangle2D s = new RoundRectangle2D.Double(0, 0, 0, 0, 20, 20); 
227 s,setFrameFromDi agonal (p[0], p[1]); 


228 return S; 

29 } 

230 } 

231 

232 /** 

233 * Makes an ellipse contained in a bounding box with two given corner points. 
234 */ 

235 Class EllipseMaker extends ShapeMaker 
236 { 

237 public EllipseMaker() 

238 { 

239 super (2); 


242 public Shape makeShape(Point2D[] p) 


{ 
244 Ellipse2D s = new Ellipse2D.Double(); 
245 s.setFrameFromDi agonal (p[0], p[1]); 
246 return sS; 
w7 } 
248 } 
249 
250 /** 
251 * Makes an arc contained in a bounding box with two given corner points, and with starting and 
252 * ending angles given by lines emanating from the center of the bounding box and ending in two 
253 * given points. To show the correctness of the angle computation, the returned shape contains the 
254 * arc, the bounding box, and the lines. 


255 */ 

256 Class ArcMaker extends ShapeMaker 
257 { 

258 public ArcMaker() 

259 { 

260 Super(4) ; 

21 } 


262 

263 public Shape makeShape(Point2D[] p) 

24 á { 

265 double centerX = (p{0].getX() + p[1] .getX()) / 2; 
266 double centerY = (p[0].getY() + p[1] .getY()) / 2; 

267 double width = Math.abs(p[1] .getX() - p[0].getxQ); 
268 double height = Math.abs(p[1] .getY() - p[0] .getY()); 
269 


270 double skewedStartAngle = Math.toDegrees(Math.atan2(-(p[2].getY() - centerY) * width, 
271 (p[2] .getX() - centerX) * height)); 

272 double skewedEndAngle = Math. toDegrees (Math. atan2(-(p[3].getY() - centerY) * width, 
273 (p[3] .getX() - centerX) * height)); 

274 double skewedAngleDifference = skewedEndAngle - skewedStartAngle; 


275 if (skewedStartAngle < 0) skewedStartAngle += 360; 
276 if (skewedAngleDifference < 0) skewedAngleDifference += 360; 
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277 
278 

279 

280 

281 

282 

283 

284 

285 

286 

287 

288 

289 

290 

291 } 
292 

293 /** 


295 


} 


Arc2D s = new Arc2D.Double(0, 0, 0, 0, skewedStartAngle, skewedAngleDifference, Arc2D.OPEN): 


s.setFrameFromDi agonal (p[0], p[1]); 


GeneralPath g = new General Path(); 

g.append(s, false); 

Rectangle2D r = new Rectangle2D.Double(); 
r.setFrameFromDi agonal (p[0], p[1]); 

g.append(r, false); 

Point2D center = new Point2D.Double(centerX, centerY); 
g.append(new Line2D.Double(center, p[2]), false); 
g.append(new Line2D.Double(center, p[3]), false); 
return g; 


294 * Makes a polygon defined by six corner points. 
* 


296 Class PolygonMaker extends ShapeMaker 


297 { 


302 


311 
312 } 
313 

314 /** 


315 * Makes a quad curve defined by two end points and a control point. 


316 */ 


public PolygonMaker() 
{ 


} 


super (6); 


public Shape makeShape(Point2D[] p) 


{ 


} 


GeneralPath s = new GeneralPath(); 
s.moveTo( (float) p[0].getX(), (float) p[0] .getY()); 
for (int i = 1; i < p.length; i++) 

s.lineTo((float) p[i].getX(), (float) p[i].getY()); 
s.closePath() ; 
return s; 


317 Class QuadCurveMaker extends ShapeMaker 


318 { 


public QuadCurveMaker() 


{ 


super (3); 


public Shape makeShape(Point2D[] p) 


{ 


return new QuadCurve2D.Double(p[0].getX(), p[0].getYQ, p[1] .getX(), p[1] .getY(), 


p(2].getX(), p[2].getYQ); 
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32 * Makes a cubic curve defined by two end points and two control points. 
33 */ 
334 Class CubicCurveMaker extends ShapeMaker 


36 public CubicCurveMaker() 
337 { 

338 super (4) ; 

39 o} 


31 public Shape makeShape(Point2D[] p) 

mo å { 

343 return new CubicCurve2D.Double(p[0].getX(), p[0].getYO, p[1].getXO, p[1] .getY(), pl2] 
344 .getX(), p[2].getYO, p[3].getXQ, p[3] .getYO); 








e RoundRectangle2D.Double(double x, double y, double width, double 
height, double arcWidth, double arcHeight) 
用 给 定 的 矩形 边框 和 弧 形 尺寸 构建 一 个 圆 角 矩形 。 参 见 图 11-4 有 关 arcWidth 和 
arcHeight 参数 的 解释 。 





e Arc2D.Double(double x, double y, double w, double h, double startAngle, 
double arcAngle, int type) 
用 给 定 的 矩形 边框 、 起 始 角 度 、 弧 形 角 度 和 弧 形 类 型 构建 一 个 弧 形 。startAngle 和 
arcAngle 在 图 11-5 中 已 做 介绍 ,type 是 Arc2D.OPEN, Arc2D.PIE 和 Arc2D.CHORD 之 一 。 






e QuadCurve2D.Double(double x1, double yl, double ctr1x, double ctrly, 
double x2, double y2) 
用 起 始点 、 控 制 点 和 结束 点 构建 一 条 二 次 曲线 。 





e CubicCurve2D.Double(double xl, double yl, double ctr1xl, double ctrlyl, 
double ctr1x2, double ctrly2, double x2, double y2) 
用 起 始点 、 两 个 控制 点 和 结束 点 构建 一 条 三 次 曲线 。 





e GeneralPath() 
构建 一 条 空 的 普通 路 径 。 
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evoid moveTo(float x, float y) 
fE (x, y) 成 为 当前 点 ， 也 就 是 下 一 个 线段 的 起 始点 。 

evoid lineTo(float x, float y) 

e void quadTo(float ctrix, float ctrly, float x, float y) 

® void curveTo(float ctrllx, float ctrlly, float ctr12x, float ctirizy, 
float x, float y) 
从 当前 点 绘制 一 个 线条 、 二 次 曲线 或 者 三 次 曲线 到 达 结 束 点 (x，y)， 并 且 使 该 结束 点 
成 为 当前 点 。 





evoid append(Shape s, boolean connect) 
将 给 定形 状 的 边框 添加 到 普通 路 径 中 去 。 如 果 布 尔 型 变量 connect 的 值 是 true 的 
话 ， 那 么 该 普通 路 径 的 当前 点 与 添加 进来 的 形状 的 起 始点 之 间 用 一 条 直线 连接 起 来 。 

e void closePath() 


从 当前 点 到 路 径 的 第 一 点 之 间 绘 制 一 条 直线 ， 从 而 使 路 径 闭合 


11.3 ”区 域 


在 上 一 节 中 ， 我 们 介绍 了 如 何 通 过 建立 由 线条 和 曲线 构成 的 普通 路 径 来 绘制 复杂 的 形 
状 。 通 过 使 用 足够 数量 的 线条 和 曲线 可 以 绘制 出 任何 一 种 形状 ,例如 ， 在 屏幕 上 和 打印 文件 
上 看 到 的 字符 的 各 种 字体 形状 ， 都 是 由 线条 和 三 次 曲线 构成 的 。 

有 时 候 ， 使 用 各 种 不 同形 状 的 区 域 ， 比 如 和 矩形 、 多 边 形 和 椭圆 形 来 建立 形状 ， 可 能 会 更 
加 容易 描述 。Java 2D API 支持 四 种 区 域 几 何 作 图 (constructive area geometry) 操作 ， 用 于 将 
两 个 区 域 组 合成 一 个 区 域 。 

e add: 组 合 区 域 包 含 了 所 有 位 于 第 一 个 区 域 或 第 二 个 区 域内 的 点 。 

esubtract: 组 合 区 域 包含 了 所 有 位 于 第 一 个 区 域内 的 点 ， 但 是 不 包括 任何 位 于 第 二 个 

区 域内 的 点 。 
o intersect: 组 合 区 域 包含 了 所 有 既 位 于 第 一 个 区 域内 ， 又 位 于 第 二 个 区 域内 的 点 。 
eexclusiveor : 组 合 区 域 包 含 了 所 有 位 于 第 一 个 区 域内 ， 或 者 是 位 于 第 二 个 区 域内 的 
所 有 点 ， 但 是 这 些 点 不 能 同时 位 于 两 个 区 域内 。 
图 11-10 显示 了 这 些 操作 的 结果 。 
如 果 要 构建 一 个 复杂 的 区 域 ， 可 以 使 用 下 面 的 方法 先 创建 一 个 默认 的 区 域 对 象 。 


Area a = new Area(); 


然后 ， 将 该 区 域 和 其 他 的 形状 组 合 起 来 : 





Ble BRAWT 635 


Ba) aes e 4 T i 
| Pod | 
| 一 一 二 -全 


E "wi oo 2 a2 8 
; FF £ S. Tf Y 
aS Oe ee ee Se | 


a ae eee oe ee eee 
T CF T F] 





图 11-10 区 域 几何 作 图 操作 


a.add(new Rectangle2D.Double(. . .)); 
a. subtract (path) ; 


Area 类 实现 了 Shape 接 口 。 可 以 用 draw 方 法 勾勒 出 该 区 域 的 边界 ， 或 者 使 用 
Graphics2D 类 的 fi11 方法 给 区 域 的 内 部 着 色 。 





e void add(Area other) 
e void subtract(Area other) 
e void intersect(Area other) 
e void exclusiveOr(Area other) 
对 该 区 域 和 other 所 代表 的 另 一 个 区 域 执行 区 域 几何 作 图 操作 ， 并 且 将 该 区 域 设置 为 执 
行 后 的 结果 。 


11.4 ”笔划 


Graphics2D 类 的 draw 操作 通过 使 用 当前 选 定 的 笔划 来 绘制 一 个 形状 的 边界 。 在 默认 
的 情况 下 ， 笔 划 是 一 条 宽度 为 一 个 像素 的 实 线 。 可 以 通过 调用 setStroke 方法 来 选 定 不 同 
的 笔划 ， 此 时 要 提供 一 个 实现 了 Stroke 接口 的 类 的 对 象 。Java 2D API 只 定义 了 一 个 这 样 的 
类 ， 即 BasicStroke 类 。 在 本 节 中 ， 我 们 将 介绍 BasicStroke 类 的 功能 。 

你 可 以 构建 任意 粗细 的 笔划 。 例 如 ， 下 面 的 方法 就 绘制 了 一 条 粗细 为 10 个 像素 的 线条 。 


g2.setStroke(new BasicStroke(10.0F)) ; 
g2.draw(new Line2D.Double(. . .)); 
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当 一 个 笔划 的 粗细 大 于 一 个 像素 的 宽度 时 ， 笔 划 的 末端 可 采用 不 同 的 样式 。 图 11-11 显 
未 了 这 些 所 谓 的 端 头 样式 。 端 头 样 式 有 下 面 三 种 : 

e 平头 样式 (butt cap) 在 笔划 的 未 端 处 就 结束 了 ; 

e 圆 头 样式 (round cap) 在 笔划 的 末端 处 加 了 一 个 半圆 ; 

© J KIEA (square cap) 在 笔划 的 末端 处 加 了 半 个 方块 。 | 

当 两 个 较 粗 的 笔划 相遇 时 ， 有 三 种 笔划 的 连接 样式 可 供 选 择 (参见 图 11-12): 


EEE Le PO Ne Pe ae | 








图 11-11 笔划 的 端 头 样式 图 11-12 ”笔划 的 连接 样式 


o 针 连 接 〈bevel join)， 用 一 条 直线 将 两 个 笔划 连接 起 来 ， 该 直线 与 两 个 笔划 之 间 的 夹 角 
的 平分 线 相 垂直 。 

o 圆 连接 (round join)， 延 长 了 每 个 笔划 ， 并 使 其 带 有 一 个 圆 头 。 

o # Ri€4 (miter join)， 通 过 增加 一 个 尖峰 ， 从 而 同时 延长 了 两 个 笔划 。 

和 斜 尖 连接 不 适合 小 角度 连接 的 线条 。 如 果 两 条 线 连接 后 的 角度 小 于 斜 尖 连接 的 最 小 角 
度 ， 那 么 应 该 使 用 斜 连接 。 斜 连接 的 使 用 ， 可 以 防止 出 现 太 长 的 尖峰 。 默 认 情 况 下 ， 和 斜 尖 连 
接 的 最 小 角度 是 10 度 。 

可 以 在 BasicStroke 构造 器 中 设 定 这 些 选 择 ， 例 如 ; 


g2.setStroke(new BasicStroke(10.0F, BasicStroke.CAP_ROUND, BasicStroke. JOIN ROUND)); 
g2.setStroke(new BasicStroke(10.0F, BasicStroke.CAP_BUTT, BasicStroke. JOIN MITER, 
15.0F /* miter limit */)); 


最 后 ， 通 过 设置 一 个 虚线 模式 ， 可 以 指定 需要 使 用 的 虚线 。 在 程序 清单 11-2 的 程序 中 ， 
可 以 选择 一 个 虚线 模式 ， 拼 出 摩 斯 电码 中 的 SOS 代码 。 虚 线 模式 是 一 个 float[] 类 型 的 数 
A, EMR TERP “GER (on) Al “WFR (off)” 的 长 度 OLE 11-13 )。 

当 构 建 Basicstroke 时 ， 可 以 指定 虚线 模式 和 虚线 相位 (dash phase)。 虚 线 相 位 用 来 表 
示 每 条 线 应 该 从 虚线 模式 的 何 处 开始 。 通 常情 况 下 ， 应 该 把 它 的 值 设置 为 0。 

float[] dashPattern = { 10, 10, 10, 10, 10, 10, 30, 10, 30,... } 





#11% BRAWT 637 


g2.setStroke(new BasicStroke(10.0F, BasicStroke.CAP_BUTT, BasicStroke. JOIN MITER, 


10.0F /* miter limit */, dashPattern, 0 /* dash phase */)); 





图 11-13 一 种 虚线 图 案 


El 注意 : 在 虚线 模式 中 ， 每 一 条 虚线 的 末端 都 可 以 应 用 端 头 样式 。 


程序 清单 11-2 中 的 程序 可 以 设 定 端 头 样式 、 连 接 
样式 和 虚线 ( 见 图 11-14 ) 。 可 以 移动 线段 的 端 头 ， 用 
以 测试 斜 尖 连接 的 最 小 角度 : 首先 选 定 斜 尖 连 接 ; 然 
后 ， 移 动 线段 末端 形成 一 个 非常 尖 的 锐角 。 可 以 看 到 
斜 尖 连接 变 成 了 一 个 斜 连 接 。 

这 个 程序 类 似 于 程序 清单 11-1 的 程序 。 当 点 击 一 
个 线段 的 末端 时 ， 鼠 标 监 听 器 就 会 记 下 操作 ， 而 鼠标 
动作 监听 器 则 监听 对 端点 的 拖 虹 操作。 一 组 单 选 按 钮 
用 以 表示 用 户 选 择 的 端 头 样式 、 连 接 样式 以 及 实 线 或 
虚线 。StrokePane1 类 的 paintCcomponent 方法 构 
建 了 一 个 GeneralPath， 它 由 连接 着 用 户 可 以 用 鼠标 
移动 的 三 个 点 的 两 条 线段 构成 。 然 后 ， 它 根据 用 户 的 





package stroke; 


import java.awt.*; 
import java.awt.event.*; 
import java.awt.geom.*; 
import javax. swing.*; 


/** 

* This program demonstrates different stroke types. 
10 * @version 1.04 2016-05-10 
11 * @author Cay Horstmann 


LL oo ~ ao Vn 和 Al N e 


yn */ 

13 public class StrokeTest 

u { 

15 public static void main(String[] args) 
16 { 

17 EventQueue.invokeLater(() -> 








图 11-14 StrokeTest 程序 
选择 构建 一 个 BasicStroke， EE 
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18 { 

19 JFrame frame = new StrokeTestFrame() : 

20 frame.setTitle("StrokeTest") ; 

21 frame. setDefaul tCloseOperation(JFrame.EXIT_ON_CLOSE) ; 
22 frame, setVisible(true) ; 

23 Di 

24 } 

25 } 

26 

27 /** 

28 * This frame lets the user choose the cap, join, and line style, and shows the resulting stroke. 
29 */ 

30 Class StrokeTestFrame extends JFrame 

31 { 


32 private StrokeComponent canvas; 
33 private JPanel buttonPanel; 


35 public StrokeTestFrame() 


36 { 

37 canvas = new StrokeComponent(); 

38 add(canvas, BorderLayout. CENTER) ; 

39 

40 buttonPanel = new JPanel (); 

41 buttonPanel .setLayout(new GridLayout(3, 3)); 

42 add(buttonPanel, BorderLayout.NORTH) ; 

43 

44 ButtonGroup group1 = new ButtonGroup(); 

45 makeCapButton("Butt Cap", BasicStroke.CAP_BUTT, group1); 

46 makeCapButton("Round Cap", BasicStroke.CAP_ROUND, group1); 

47 makeCapButton ("Square Cap", BasicStroke.CAP_SQUARE, group1); 

48 

49 ButtonGroup group2 = new ButtonCroup(); 

50 makeJoinButton("Miter Join", BasicStroke.JOIN_MITER, group2); 
51 makeJoinButton("Bevel Join", BasicStroke.JOIN BEVEL, group2); 
52 makeJoinButton("Round Join", BasicStroke.JOIN_ROUND, group2); 
53 

54 ButtonGroup group3 = new ButtonGroup(); 

55 makeDashButton("Solid Line", false, group3); 

56 makeDashButton("Dashed Line", true, group3); 

57 } 

58 

59 /*s 

60 * Makes a radio button to change the cap style. 


61 * @aram label the button label 

62 * @param style the cap style 

63 * @aram group the radio button group 

64 ay 

65 private void makeCapButton(String label, final int style, ButtonGroup group) 
66 { 


67 // select first button in group 

68 boolean selected = group.getButtonCount() == 0; 

69 RadioButton button = new JRadioButton(label, selected); 
70 buttonPanel ,add (button) ; 


71 group. add (button) ; 
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button.addActionListener(event -> canvas.setCap(style)); 
pack() ; 
} 


[** 
* Makes a radio button to change the join style. 
* @param label the button label 
* @param style the join style 
* Qparam group the radio button group 
* 
private void makeJoinButton(String label, final int style, ButtonGroup group) 
{ 
// select first button in group 
boolean selected = group.getButtonCount() == 0; 
RadioButton button = new JRadioButton(label, selected) ; 
buttonPanel .add (button) ; 
group.add(button) ; 
button. addActionListener(event -> canvas.setJoin(style)); 


} 


/** 
* Makes a radio button to set solid or dashed lines 
* @param label the button label 
* @param style false for solid, true for dashed lines 
* @param group the radio button group 
* 
private void makeDashButton(String label, final boolean style, ButtonGroup group) 
{ 
// select first button in group 
boolean selected = group.getButtonCount() == 0; 
RadioButton button = new JRadioButton(label, selected) ; 
buttonPanel .add (button) ; 
group.add(button) ; 
button. addActionListener(event -> canvas.setDash(style)) ; 


/** 


* This component draws two joined lines, using different stroke objects, and allows the user to 
* drag the three points defining the lines. 


了 


class StrokeComponent extends JComponent 


{ 


private static final Dimension PREFERRED _SIZE = new Dimension(400, 400); 
private static int SIZE = 10; 


private Point2D[] points; 
private int current; 
private float width; 
private int cap; 

private int join; 

private boolean dash; 


public StrokeComponent () 
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} 


{ 


addMouseLi stener (new MouseAdapter() 


public void mousePressed(MouseEvent event) 
{ 
Point p = event.getPoint(); 
for (int i = 0; i < points.length; i++) 
{ 
double x = points[i].getX() - SIZE / 2; 
double y = points[i].getY() - SIZE / 2; 


Rectangle2D r = new Rectangle2D.Double(x, y, SIZE, SIZE); 


if (r.contains(p)) 


current = 1; 
return; 
} 


} 
} 


public void mouseReleased(MouseEvent event) 
{ 
current = -1; 
} 
}); 


addMouseMotionListener(new MouseMoti onAdapter() 


public void mouseDragged(MouseEvent event) 
{ 
if (current == -1) return; 
points[current] = event.getPoint(); 
repaint(); 
} 
}); 


points = new Point2D[3]; 

points(0] = new Point2D.Double(200, 100); 
points[1] = new Point2D.Double(100, 200); 
points[2] = new Point2D.Double(200, 200); 
current = -1; 

width = 8.0F: 


public void paintComponent (Graphics g) 


{ 


Graphics2D g2 = (Graphics2D) g; 
GeneralPath path = new General Path(); 
path.moveTo((float) points(0].getXQ, (float) points[0].getY()); 
for (int i = 1; i < points. length; i++) 
path. lineTo((float) points[i] .getX(), (float) points[i].getY(); 
BasicStroke stroke; 
if (dash) 
{ 


float miterLimit = 10.0F; 
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180 float[] dashPattern = { 10F, 10F, 10F, 10F, 10F, 10F, 30F, 10F, 30F, 10F, 30F, 10F, 10F, 
181 10F, 10F, 10F, 10F, 30F }; 

182 float dashPhase = 0; 

183 stroke = new BasicStroke(width, cap, join, miterLimit, dashPattern, dashPhase) ; 
184 } 

185 else stroke = new BasicStroke(width, cap, join); 

186 g2.setStroke(stroke) ; 

187 g2.draw(path) ; 

188 } 

189 

190 /** 


191 * Sets the join style. 
192 * @aram j the join style 
$ 


194 public void setJoin(int j) 


is è { 

196 join = j; 
197 repaint(); 
1%8  } 

199 

20 /** 


201 * Sets the cap style. 
202 * @aram c the cap style 


203 */ 

204 public void setCap(int c) 
20 { 

206 cap = C; 

207 repaint(); 

208 } 

209 

20 /** 


211 * Sets solid or dashed lines. 
212 * @param d false for solid, true for dashed lines 


213 */ 

214 public void setDash(boolean d) 
us { 

216 dash = d; 

217 repaint); 

28 } 


20 public Dimension getPreferredSize() { return PREFERRED_SIZE; } 
221 } 





e void setStroke(Stroke s) 
将 该 图 形 上 下 文 的 笔划 设置 为 实现 了 Stroke 接口 的 给 定 对 象 。 





e BasicStroke(float width) 
e BasicStroke(float width, int cap, int join) 





642 Java ZSRR KI FARAH 


e BasicStroke(float width, int cap, int join, float miterlimit) 
eBasicStroke(float width, int cap, int join, float miterlimit, 
float[] dash, float dashPhase) 

用 给 定 的 属性 构建 一 个 笔划 对 象 。 


= os iets Ee tial 
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参数 : width 画笔 的 宽度 | 
cap 端 头 样式 ， 它 是 CAP_BUTT 、CAP_ROUND 和 CAP_SQUARE 三 

种 样式 中 的 一 个 | 

join 连接 样式 ， 它 是 JOIN_BEVEL, JOIN_MITER 和 JOIN_ROUND 

三 种 样式 中 的 一 个 | 

miterlimit 用 度数 表示 的 角度 ， 如 果 小 于 这 个 角度 ， 斜 尖 连 接 将 呈 

现 为 斜 连接 

dash 虚线 笔划 的 填充 部 分 和 空白 部 分 交替 出 现 的 一 组 长 度 | 


dashPhase 虚线 模式 的 “相位 ”; 位 于 笔划 起 始点 前 面 的 这 段 长 度 被 候 | 
设 为 已 经 应 用 了 该 虚线 模式 | 


11.5 ”着 色 


当 填 充 一 个 形状 的 时 候 ， 该 形状 的 内 部 就 上 了 颜色 。 使 用 setPaint 方法 ， 可 以 把 颜色 
的 样式 设 定 为 一 个 实现 了 Paint 接口 的 类 的 对 象 。Java 2D API 提供 了 三 个 这 样 的 类 : 

o Color 类 实现 了 Paint 接口 。 如 果 要 用 单 色 填充 形状 ， 只 需要 用 Color 对 象 调用 
setPaint 方法 即 可 ， 例 如 : 
g2.setPaint(Color. red); 

eGradientPaint 类 通过 在 两 个 给 定 的 颜色 值 之 间 进 行 渐变 ， 从 而 改变 使 用 的 颜色 ( 参 
见 图 11-15), 

e TexturePaint 类 用 一 个 图 像 重 复 地 对 一 个 区 域 进行 着 色 ( 见 图 11-16 )。 
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图 11-15 渐变 着 色 图 11-16 纹理 着 色 


可 以 通过 指定 两 个 点 以 及 在 这 两 个 点 上 想 使 用 的 颜色 来 构建 一 个 G6radientPaint 对 
A, Bl: 


g2.setPaint(new GradientPaint(pl, Color.RED, p2, Color. YELLOW)); 
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上 面 语 句 将 沿 着 连接 两 个 点 之 间 的 直线 的 方向 对 颜色 进行 渐变 ， 而 沿 着 与 该 连接 线 垂 直 
方向 上 的 线条 颜色 则 是 不 变 的 。 超 过 线条 端点 的 各 个 点 被 赋予 端点 上 的 颜色 。 

另外 ， 如 果 调 用 GradientPaint 构造 器 时 cyclic SAREA true, Bp: 

g2.setPaint(new GradientPaint(pl, Color.RED, p2, Color.YELLOW, true)); 
那么 颜色 将 循环 变换 ， 并 且 在 端点 之 外 仍然 保持 这 种 变换 。 

如 果 要 构建 一 个 TexturePaint 对 象 ， 需 要 指定 一 个 BufferedImage 和 一 个 销 位 矩形 。 


g2.setPaint(new TexturePaint(bufferedImage, anchorRectangle)) ; 

在 本 章 后 面部 分 详细 讨论 图 像 时 ， 我 们 再 介绍 BufferedImage 类 。 获 取 缓 冲 图 像 最 简 
单 的 方式 就 是 读 人 图 像 文件 : 

bufferedImage = ImageI0.read(new File("blue-ball.gif")); 

锚 位 矩形 在 x 和 y 方 向 上 将 不 断 地 重复 延伸 ， 使 之 平 铺 到 整个 坐标 平面 。 图 像 可 以 伸 
缩 ， 以 便 纳入 该 锚 位 ， 然 后 复制 到 每 一 个 平 铺 显 示 区 中 。 





evoid setPaint(Paint s) 
将 图 形 上 下 文 的 着 色 设 置 为 实现 了 Paint 接口 的 给 定 对 象 。 





e GradientPaint(float xl, float yl, Color colorl, float x2, float y2, 
Color color2) 

e GradientPaint(float xl, float yl, Color colorl, float x2, float y2, 
Color color2, boolean cyclic) 

e GradientPaint(Point2D pl, Color colorl, Point2D p2, Color color2) 
e GradientPaint(Point2D pl, Color colorl, Point2D p2, Color color2, boolean 
cyclic) 

构建 一 个 渐变 着 色 的 对 象 ， 以 便 用 颜色 来 填充 各 个 形状 ， 其 中 ， 起 始点 的 颜色 为 
color1， 结 束 点 的 颜色 为 co1or2， 而 两 个 点 之 间 的 颜色 则 是 以 线性 的 方式 渐变 。 沿 
着 连接 起 始点 和 结束 点 之 间 的 线条 相 垂 直 的 方向 上 的 线条 颜色 是 恒定 不 变 的 。 在 默认 
的 情况 下 ， 渐 变 着 色 不 是 循环 变换 的 。 也 就 是 说 ， 起 始点 和 结束 点 之 外 的 各 个 点 的 颜 
色 是 分 别 与 起 始点 和 结束 点 的 颜色 相同 的 。 如 果 渐 变 着 色 是 循环 的 ， 那 么 颜色 是 连续 
变换 的 ， 首 先 返 回 到 起 始点 的 颜色 ， 然 后 在 两 个 方向 上 无 限 地 重复 。 





e TexturePaint(BufferedImage texture, Rectangle2D anchor) 
建立 纹理 着 色 对 象 。 锚 位 矩形 定义 了 色 的 平 铺 空间 ， 该 矩形 在 x 和 y 方向 上 不 断 地 重 
复 延 伸 ， 纹 理 图 像 则 被 缩放 ， 以 便 填 充 每 个 平 铺 空间 。 
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11.6 ”坐标 变换 


假设 我 们 要 绘制 一 个 对 象 ， 比 如 汽车 。 从 制造 商 的 规格 说 明 书 中 可 以 了 解 到 汽车 的 高 
度 、 轴 距 和 整个 车 身 的 长 度 。 如 果 设 定 了 每 米 的 像素 个 数 ， 当 然 就 可 以 计算 出 所 有 像素 的 位 
置 。 但 是 ， 可 以 使 用 更 加 容易 的 方法 : 让 图 形 上 下 文 来 执行 这 种 转换 。 


g2.scale(pixelsPerMeter, pixelsPerMeter); 
g2.draw(new Line2D.Double(coordinates in meters)); // converts to pixels and draws scaled line 


Graphics2D 类 的 scale 方法 可 以 将 图 形 上 下 文中 的 坐标 变换 设置 为 一 个 比例 变换 。 这 
种 变换 能 够 将 用 户 坐 标 (用户 设 定 的 单元 ) 转换 成 设备 坐标 (pixel， 即 像素 )。 图 11-17 显示 
了 如 何 进行 这 种 变换 的 方法 。 
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图 11-17 用 户 坐 标 与 设备 坐标 


坐标 变换 在 实际 应 用 中 非常 有 用 ， 程 序 员 可 以 使 用 方便 的 坐标 值 进行 各 种 操作 ， 图 形 上 
下 文 则 负责 执行 将 坐标 值 变 换 成 像素 的 复杂 工作 。 

这 里 有 四 种 基本 的 变换 . 

o 比例 缩放 : 放大 和 缩小 从 一 个 固定 点 出 发 的 所 有 距离。 

o 旋转 : 环绕 着 一 个 固定 中 心 旋转 所 有 点 。 

e FB: 将 所 有 的 点 移动 一 个 固定 量 。 

e 切 变 : 使 一 个 线条 固定 不 变 ， 再 按照 与 该 固定 线条 之 间 的 距离 ， 成 比例 地 将 与 该 线条 

平行 的 各 个 线条 “滑动 ”一 个 距离 量 。 

图 11-18 显示 了 对 一 个 单位 的 正方 形 进行 这 四 种 基本 变换 操作 的 效果 。 

Graphics2D 类 的 scale, rotate, translate 和 shear 等 方法 用 以 将 图 形 上 下 文中 
的 坐标 变换 设置 成 为 以 上 这 些 基 本 变换 中 的 一 种 。 

可 以 组 合 不 同 的 变换 操作 。 例 如 ， 你 可 能 想 对 图 形 进 行 旋转 和 两 倍 尺 寸 放大 的 操作 ， 这 
时 ， 可 以 同时 提供 旋转 和 比例 缩放 的 变换 : 


g2.rotate(angle) ; 
g2.scale(2, 2); 
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g2.draw(. . .); 





图 11-18 ”基本 的 变换 


在 这 种 情 次 下 ， 变 换 方法 的 顺序 是 无 关 紧 要 的 。 然 而 ， 在 大 多 数 变换 操作 中 ， 顺 序 却 是 
很 重要 的 。 例 如 ， 如 果 想 对 形状 进行 旋转 和 切 变 操作 ， 那 么 两 种 变换 操作 的 不 同 执行 序列 ， 
将 会 产生 不 同 的 图 形 。 你 必须 明确 想 要 得 到 的 是 什么 样 的 图 形 ， 图 形 上 下 文 将 按照 你 所 提供 
的 相反 顺序 来 应 用 这 些 变 换 操作 。 也 就 是 说 ， 你 最 后 提供 的 方法 会 被 最 先 应 用 。 

可 以 根据 你 的 需要 提供 任意 多 的 变换 操作 。 例 如 ， 假设 你 提供 了 下 面 这 个 变换 操作 序列 : 


g2.translate(x, y); 
g2.rotate(a); 
g2.translate(-x, -y); 


最 后 一 个 变换 操作 ( 它 是 第 一 个 被 应 用 的 ) 将 把 某 个 形状 从 点 (x，y) 移动 到 原点 ， 第 
二 个 变换 将 使 该 形状 围绕 着 原点 旋转 一 个 角度 a， 最 后 一 个 变换 方法 又 重新 把 该 形状 从 原 
凡 移 动 到 点 (x，y) 处 。 总 体 效 果 就 是 该 形状 围绕 着 中 心 点 (x，y) 进行 了 一 次 旋转 ( 参 
见 图 11-19 )。 围 绕 着 原点 之 外 的 任意 点 进行 旋转 是 一 个 很 常见 的 操作 ， 所 以 我 们 采用 下 面 的 
快捷 方法 : 

g2.rotate(a, x, y); 

如 果 对 和 矩阵 论 有 所 了 解 ， 那 么 就 会 知道 所 有 操作 〈 诸 如 旋转 、 平 移 、 缩 放 、 切 变 ) 和 由 
这 些 操作 组 合 起 来 的 操作 都 能 够 以 如 下 和 矩阵 变换 的 形式 表示 出 来 : 

















i 这 x 
Yn | = bd f y 
1 001 1 





这 种 变换 称 为 仿 射 变换 (affine transformation), Java 2D API 中 的 AffineTransform 类 
就 是 用 于 描述 这 种 变换 的 。 如 果 你 知道 某 个 特定 变换 矩阵 的 组 成 元 素 ， 就 可 以 用 下 面 的 方法 
直接 构造 它 : 

AffineTransform t = new AffineTransform(a, b, c, d, e, f); 

另外 ， 工 厂 方法 getRotateInstance, getScaleInstance, getTranslateInstance 
和 getShear Instance 能 够 构建 出 表示 相应 变换 类 型 的 矩阵 。 例 如， 调用 下 面 的 方法 : 
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图 11-19 组 合 变换 操作 的 应 用 


t = AffineTransform.getScaleInstance(2.0F, 0.5F); 

将 返回 一 个 与 下 面 这 个 矩阵 相 一 致 的 变换 。 
2 0 0 
0 0.5 0 


0 U 1 
最 后 ， 实 例 方 法 setToRotation, setToScale, setToTranslation fl] setToShear 


用 于 将 变换 对 象 设 置 为 一 个 新 的 类 型 。 下 面 是 一 个 例子 : 
t.setToRotation(angle); // sets t to a rotation 
可 以 把 图 形 上 下 文 的 坐标 变换 设置 为 一 个 AffineTransform 对 象 : 
g2.setTransform(t); // replaces current transformation 


不 过 ， 在 实际 运用 中 ， 不 要 调用 setTransform 操作 ， 因 为 它 会 取代 图 形 上 下 文中 可 能 存 
在 的 任何 现 有 的 变换 。 例 如 ， 一 个 用 以 横向 打印 的 图 形 上 下 文 已 经 有 了 一 个 90” 的 旋转 变 
换 ， 如 果 调 用 方法 setTransfrom， 就 会 删除 这 样 的 旋转 操作 。 可 以 调用 transform 方法 
作为 替代 方案 : 


g2.transform(t); // composes current transformation with t 


它 会 把 现 有 的 变换 操作 和 新 的 AffineTransform 对 象 组 合 起 来 。 
如 果 只 想 临 时 应 用 某 个 变换 操作 ， 那 么 应 该 首先 获得 旧 的 变换 操作 ， 然 后 和 新 的 变换 操 
作 组 合 起 来 ， 最 后 当 你 完成 操作 时 ， 再 还 原 旧 的 变换 操作 : 
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AffineTransform oldTransform = g2.getTransform(); // save old transform 
g2.transform(t); // apply temporary transform 

draw on 92 

g2.setTransform(oldTransform); // restore old transform 





e AffineTransform(double a, double b, double c, double d, double e, 
double f) 
e AffineTransform(float a, float b, float c, float d, float e, float f) 


用 下 面 的 矩阵 构建 该 仿 射 变换 。 


WW -C @ 
bd f 
0 0 1 
e AffineTransform(double[] m) 
e AffineTransform(float[] m) 
用 下 面 的 矩阵 构建 该 仿 射 变换 。 
m[0] ml2] m[4] 
m[1] mf3] m[5] 
0 0 1 


estatic AffineTransform getRotateInstance(double a) 
创建 一 个 围绕 原点 、 旋 转角 度 为 a OUE) 的 旋转 变换 。 其 变换 矩阵 是 : 
cos(a) -sin(a) 0 
sin(a) cos(a) 0 
0 0 1 
如 有 果 a 在 0 到 7/2 之 间 ， 那么 图 形 将 沿 着 x 轴 正 半 轴 向 y 轴 正 半 轴 的 方向 旋转 。 
e static AffineTransform getRotateInstance(double a, double x, double y) 
创建 一 个 围绕 点 (x,y)、 旋 转角 度 为 a (弧度 ) 的 旋转 变换 。 


estatic AffineTransform getScaleInstance(double sx, double sy) 


创建 一 个 比例 缩放 变换 。x 轴 缩 放 幅 度 为 sx; y 轴 缩 放 幅 度 为 sy。 其 变换 矩阵 是 : 


sxx 0 0 
0 sy 0 
G „Øs d 


e static AffineTransform getShearInstance(double shx, double shy) 


创建 一 个 切 变 变换 。x 轴 切 变 shx; y 轴 切 变 shy。 其 变换 矩阵 是 : 


1 shx O 
shy 1 0 
0 0 1 


e static AffineTransform getTranslateInstance(double tx, double ty) 
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创建 一 个 平移 变换 。x 轴 平 移 tx; 》 轴 平移 ty。 其 变换 矩阵 是 : 


i 0 Y 
0 1 ty 
0 0 1 


e void setToRotation(double a) 

e void setToRotation(double a, double x, double y) 

e void setToScale(double sx, double sy) 

e void setToShear(double sx, double sy) 

e void setToTranslation(double tx, double ty) 
用 给 定 的 参数 将 该 变换 设置 为 一 个 的 基本 变换 。 如 果 要 了 解 基本 变换 和 它们 的 参数 说 
明 ， 请 参见 getXxxInstance 方法 。 





evoid setTransform(AffineTransform t) 
以 七 来 取代 该 图 形 上 下 文中 现 有 的 坐标 变换 。 


e void transform(AffineTransform t) 
将 该 图 形 上 下 文 的 现 有 坐标 变换 和 七 组合 起 来 。 


e void rotate(double a) 


e void rotate(double a, double x, double y) 

e void scale(double sx, double sy) 

e void shear(double sx, double sy) 

e void translate(double tx, double ty) 
将 该 图 形 上 下 文中 现 有 的 坐标 变换 和 一 个 带 有 给 定 参数 的 基本 变换 组 合 起 来 。 如 果 要 
了 解 基 本 变换 和 它们 的 参数 说 明 ， 请 参见 AffineTransform.getXxxInstance 方法 。 


11.7 B 


通过 在 图 形 上 下 文中 设置 一 个 剪 切 形状 ， 就 可 以 将 所 有 的 绘图 操作 限制 在 该 前 切 形状 内 
部 来 进行 。 

g2.setClip(clipShape); // but see below 

g2.draw(shape); // draws only the part that falls inside the clipping shape 


但 是 ， 在 实际 应 用 中 ， 不 应 该 调用 这 个 setc1ip 操作 ， 因 为 它 会 取代 图 形 上 下 文中 可 能 
存在 的 任何 剪 切 形状 。 例 如 ， 正 如 在 本 章 的 后 面部 分 所 看 到 的 那样 ， 用 于 打印 操作 的 图 形 上 
下 文 就 具有 一 个 剪 切 矩形 ， 以 确保 你 不 会 在 页 边 距 上 绘图 。 相 反 ， 你 应 该 调用 clip 方法 。 

g2.clip(clipShape); // better 

Clip PARARE Pee) ot AY BY DIZ AK Te] A BY) BY FZ AR A 2S 
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如 果 只 想 临 时 地 使 用 一 个 剪 切 区 域 的 话 ， 那 么 应 该 首先 获得 旧 的 剪 切 形状 ， 然 后 添加 新 
的 剪 切 形状 ， 最 后 ， 在 完成 操作 时 ， 再 还 原 旧 的 筋 切 形状 : 


Shape oldClip = g2.getClip(); // save old clip 
g2.clip(clipShape); // apply temporary clip 
draw on 92 

g2.setClip(oldClip); // restore old clip 


在 图 11-200 8S, RITZ T — T30 
功能 ， 它 绘制 了 一 个 按照 复杂 形状 进行 剪 切 的 相当 
出 色 的 线条 图 案 ， 即 一 组 字符 的 轮 廊 。 

如 果 要 获得 字符 的 外 形 ， 需 要 一 个 字体 泻 染 上 
下 文 ( font render context)。 请 使 用 Graphics2D 类 
的 getFontRenderContext 方法 : 图 11-20 ”按照 字母 形状 前 切 出 的 线条 图 案 


FontRenderContext context = g2.getFontRenderContext() ; 
RA, ERE MSE FEB PPR RE EP OCR BIE TextLayout XZ: 


TextLayout layout = new TextLayout("Hello", font, context); 


这 个 文本 布局 对 象 用 于 描述 由 特定 字体 泻 染 上 下 文 所 演 染 的 一 个 字符 序列 的 布局 。 这 种 
布局 依赖 于 字体 泻 染 上 下 文 ， 相 同 的 字符 在 屏幕 上 或 者 打印 机 上 看 起 来 会 有 不 同 的 显示 。 

对 我 们 当前 的 应 用 来 说 ， 更 重要 的 是 ，get0ut1ine 方法 将 会 返回 一 个 Shape 对 象 ， 这 
个 Shape 对 象 用 以 描述 在 文本 布局 中 的 各 个 字符 轮廓 的 形状 。 字 符 轮 廓 的 形状 从 原点 (0, 0) 
开始 ， 这 并 不 适合 大 多 数 的 绘图 操作 。 因 此 ， 必 须 为 getoutline 操作 提供 一 个 仿 射 变换 操 
作 ， 以 便 设 定 想 要 的 字体 轮廓 所 显示 的 位 置 : 


AffineTransform transform = AffineTransform.getTranslateInstance(0, 100); 
Shape outline = layout.getOutline(transform) ; 


接着 ,我 们 把 字体 的 轮廓 附加 给 剪 切 的 形状 : 


GeneralPath clipShape = new GeneralPath(); 
clipShape.append(outline, false); 


最 后 ， 我 们 设置 剪 切 形状 ， 并 且 绘 制 一 组 线条 。 线 条 仅仅 在 字符 边界 的 内 部 显示 : 


g2.setClip(clipShape) ; 
Point2D p = new Point2D.Double(0, 0); 
for (int i = 0; i < NLINES; i++) 
{ 
doublex=...} 
doubley=...; 
Point2D q = new Point2D.Double(x, y); 
g2.draw(new Line2D.Double(p, q)); // lines are clipped 









evoid setClip(Shape s) 1.2 
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将 当前 的 剪 切 形状 设置 为 形状 s。 
e Shape getClip() 1.2 
返回 当前 的 剪 切 形状 。 











è void clip(Shape s) 
将 当前 的 剪 切 形状 和 形状 s 相交 。 
èe FontRenderContext getFontRenderContext() 
返回 一 个 构建 TextLayout HRA UEFA EFX 





è TextLayout(String s, Font f, FontRenderContext context) 
根据 给 定 的 字符 串 和 字体 来 构建 文本 布局 对 象 。 方 法 中 使 用 字体 演 染 上 下 文 来 获取 特 
定 设备 的 字体 属性 。 

e float getAdvance( ) 
返回 该 文本 布局 的 宽度 。 
e float getAscent() 
e float getDescent() 
返回 基准 线 上 方 和 下 方 该 文本 布局 的 高 度 。 
e float getLeading() 
返回 该 文本 布局 使 用 的 字体 中 相 邻 两 行 之 间 的 距离 。 


11.8 ”透明 与 组 合 


在 标准 的 RGB 颜色 模型 中 ， 每 种 颜色 都 是 由 它 的 红 、 绿 和 蓝 这 三 种 成 分 来 描述 的 。 但 
是 ， 用 它 来 描述 透明 或 者 部 分 透明 的 图 像 区域 也 是 非常 方便 的 。 当 你 将 一 个 图 像 置 于 现 有 图 
像 的 上 面 时 ， 透 明 的 像素 完全 不 会 遮挡 它们 下 面 的 像素 ， 而 部 分 透明 的 像素 则 与 它们 下 面 的 
像素 相 混 合 。 图 11-21 显示 了 一 个 部 分 透明 的 矩形 和 一 个 图 像 相 重 羡 时 所 产生 的 效果 ， 我 们 
仍然 可 以 透 过 和 矩形 看 到 该 图 像 的 细节 。 
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在 Java 2D API 中 ， 透 明 是 由 一 个 透明 度 通道 (alpha channel) 来 描述 的 。 每 个 像素 ， 除 
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了 它 的 红 、 绿 和 蓝 色 部 分 外 ， 还 有 一 个 介 于 0 (完全 透明 ) 和 1 (部 分 透明 ) 之 间 的 透明 度 
(alpha) 值 。 例 如 ， 图 11-21 中 的 矩形 填充 了 一 种 淡 黄色 ， 透 明度 为 50%: 

new Color(0.7F, 0.7F, 0.0F, 0.5F); 

MCIRNG-EMEKAAERESBE-EN KASH AL. DAE RR A 
目标 像素 的 颜色 和 透明 度 值 混合 或 者 组 合 起 来 。 从 事 计算 机 图 形 学 研究 的 Porter 和 Duff B 
经 阐明 了 在 这 个 混合 过 程 中 的 12 种 可 能 的 组 合 原则 ，Java 2D API 实 现 了 所 有 的 这 些 原 
则 。 在 继续 介绍 这 个 问题 之 前 ， 需 要 指出 的 是 ， 这 些 原 则 中 只 有 两 个 原则 有 实际 的 意义 。 如 
果 你 发 现 这 些 原则 星 涩 难 懂 或 者 难以 搞 清楚 ， 那 么 只 使 用 SRC_OVER 原则 就 可 以 了 。 它 是 
Graphics2D 对 象 的 默认 原则 ， 并 且 它 产生 的 结果 最 直接 。 

下 面 是 这 些 规则 的 原理 。 假 设 你 有 了 一 个 透明 度 值 为 as 的 源 像 素 ， 在 该 图 像 中 ， 已 经 仔 
在 了 一 个 透明 度 值 为 av 的 目标 像素 ， 你 想 把 两 个 像素 组 合 起 来 。 图 11-22 的 示意 图 显示 了 如 
何 设 计 一 个 像素 的 组 合 原 则 。 

Porter 和 Duff 将 透明 度 值 作为 像素 颜色 将 被 使 用 的 概率 。 从 源 像素 的 角度 来 看 ， 存 在 
一 个 概率 a.， 它 是 源 像素 颜色 被 使 用 的 概率 ; 还 存在 一 个 概率 - as， 它 是 不 在 乎 是 否 使 
用 该 像素 颜色 的 概率 。 同 样 的 原则 也 适用 于 目标 像 
素 。 当 组 合 颜色 时 ， 我 们 假设 源 像素 的 概率 和 目标 像 
素 的 概率 是 不 相关 的 。 那 么 正如 图 11-22 Fras, A 
种 组 合 情 况 。 如 果 源 像素 想 要 使 用 它 的 颜色 ， 而 目标 
像素 也 不 在 乎 ， 那 么 很 自然 的 ， 我 们 就 只 使 用 源 像素 
的 颜色 。 这 也 是 为 什么 右上 角 的 和 矩形 框 用 “S” 来 标 
志 的 原因 了 ， 这 种 情况 的 概率 为 as: (1 - ap)。 同 理 ， 
左下 角 的 矩形 框 用 “D ”来 标志 。 如 果 源 像素 和 目标 
像素 都 想 选 择 自 己 的 颜色 ， 那 该 怎么 办 才 好 呢 ? 这 里 
就 要 应 用 Porter-Duff 原则 了 。 如 果 我 们 认为 源 像素 II 
比较 重要 ， 那 么 我 们 在 右 下 角 的 矩形 框 内 也 标志 上 一 ”图 11.29 设计 一 个 像素 组 合 的 原则 
个 “S”。 这 个 规则 被 称 为 SRC_OVER。 在 这 个 规则 中 ， 

我 们 赋予 源 像素 颜色 的 权 值 as， 目 标 像素 颜色 的 权 值 为 (1 - a) :ap， 然 后 将 它们 组 合 
起 来 。 

这 样 产 生 的 视觉 效果 是 源 像素 与 目标 像素 相 混合 的 结果 ， 并 且 优 先 选 择 给 定 的 源 像素 的 
颜色 。 特 别 是 ， 如 果 w 为 1， 那么 根本 就 不 用 考虑 目标 像素 的 颜色 。 如 果 as 为 0， 那 么 源 像 
素 将 是 完全 透明 的 ， 而 目标 像素 颜色 则 是 不 变 的。 

还 有 其 他 的 规则 ， 可 以 根据 置 于 概率 示意 图 各 个 框 中 的 字母 来 理解 这 些 规则 的 概念 。 
表 11-1 和 图 11-23 显示 了 Java 2D API 支持 的 所 有 这 些 规则 。 图 11-23 中 的 各 个 图 像 显 示 了 
当 你 使 用 透明 度 值 为 0.75 的 矩形 源 区 域 和 透明 度 值 为 1.0 的 椭圆 目标 区 域 组 合 时 ， 所 显示 的 
各 种 组 合 效果 。 
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图 11-23 ”Porter-Du 任 组 合 规则 


表 11-1 Porter-Duff 组 合 规则 








规 w 解释 

CLEAR 源 像素 清除 目标 像素 

SRC 源 像素 覆盖 目标 像素 和 空 像素 

DST 源 像素 不 影响 目标 像素 

SRC_OVER 源 像 素 和 目标 像素 混合 ， 并 日 覆盖 空 像素 

DST_OVER 源 像素 不 影响 目标 像素 ， 并 且 不 覆盖 空 像素 

SRC_IN 源 像素 覆盖 目标 像素 

SRC_OUT 源 像素 清除 目标 像素 ， 并 且 覆 盖 空 像素 

DST_IN 源 像素 的 透明 度 值 修改 目标 像素 的 透明 度 值 

DST_OUT 源 像素 的 透明 度 值 取 反 修改 目标 像素 的 透明 度 值 

SRC_ATOP 源 像素 和 目标 像素 相 混 合 

DST_ATOP 源 像素 的 透明 度 值 修改 目标 像素 的 透明 度 值 。 源 像素 覆盖 空 像素 
XOR 源 像素 的 透明 度 值 取 反 修 改 目 标 像素 的 透明 度 值 。 源 像素 覆盖 空 像素 


如 你 所 见 ， 大 多 数 规则 并 不 是 非常 有 用 。 例 如 ，DST_IN 规则 就 是 一 个 极端 的 例子 。 它 
根本 不 考虑 源 像素 颜色 ， 但 是 却 使 用 了 源 像素 的 透明 度 值 来 影响 目标 像素 。SRC 规则 可 能 是 
有 用 的 ， 它 强制 使 用 源 像素 颜色 ， 而 且 关 闭 了 与 目标 像素 相 混合 的 特性 。 

如 果 要 了 解 更 多 的 关于 Porter-Duff 规 则 的 信息 ， 请 参阅 Foley, Dam 和 Feiner 等 撰写 的 
《 Computer Graphics: Principles and Practice, Second Edition 》。 

你 可 以 使 用 Graphics2D0 类 的 setComposite 方法 安装 一 个 实现 了 Composite 接口 的 
类 的 对 象 。Java 2D API 提供 了 这 样 的 一 个 类 ， 即 AlphaComposite 它 实 现 了 图 11-23 中 的 
所 有 的 Porter-Duff 规则 。 
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AlphaComposite 类 的 工厂 方法 getInstance 用 来 产生 AlphaComposite 对 象 ， 此 时 
需要 提供 用 于 源 像 素 的 规则 和 透明 度 值 。 例 如 ， 可 以 考虑 使 用 下 面 的 代码 : 


int rule = AlphaComposite.SRC_OVER; 

float alpha = 0.5f; 
g2.setComposite(AlphaComposite.getInstance(rule, alpha)); 
g2.setPaint (Color. blue) ; 

g2. fill (rectangle) ; 


这 时 ， 和 矩形 将 使 用 蓝 色 和 值 为 0.5 的 透明 度 进行 着 色 。 因 为 该 组 合 规则 是 SRC_OVER， 
所 以 它 透 明 地 置 于 现 有 图 像 的 上 面 。 

程序 清单 11-3 中 的 程序 深入 地 研究 了 这 些 组 合 规则 。 可 以 从 组 合 框 中 选择 一 个 规则 ， 调 
节 滑 动 条 来 设置 A1phaComposite 对 象 的 透明 度 值 。 

此 外 ， 对 每 一 条 规则 该 程序 都 显示 了 一 条 文字 描述 。 请 注意 ， 描 述 是 根据 组 合 规则 表 计 
算 而 来 的 。 例 如 ， 第 二 行 中 的 “DS” 表 示 的 就 是 “与 目标 像素 相 混合 ”。 

该 程序 有 一 个 重要 的 缺陷 : 它 不 能 保证 和 屏幕 相对 应 的 图 形 上 下 文 一 定 具 有 透明 通道 。 
(实际 上 ， 它 通常 没有 这 个 透明 通道 )。 当 像素 被 放 到 没有 透明 通道 的 目标 像素 之 上 的 时 候 ， 
这 些 像素 的 颜色 会 与 目标 像素 的 透明 度 值 相 乘 ， 而 其 透明 度 值 却 被 弃 用 了 。 因 为 许多 Porter- 
Duff 规 则 都 使 用 目标 像素 的 透明 度 值 ， 因 此 目标 像素 的 透明 通道 是 很 重要 的 。 由 于 这 个 原 
因 ， 我 们 使 用 了 一 个 采用 ARGB 颜色 模型 的 缓存 图 像 来 组 合 各 种 形状 。 在 图 像 被 组 合 后 ， 我 
们 就 将 产生 的 图 像 在 屏幕 上 绘制 出 来 : 


BufferedImage image = new BufferedImage(getWidth(), getHeight(), BufferedImage. TYPE_INT_ARGB) ; 
Graphics2D gImage = image.createGraphics(); 

// now draw to gImage 

g2.drawlmage(image, null, 0, 0); 


程序 清单 11-3 和 程序 清单 11-4 展示 了 框 体 和 构件 类 ， 程 序 清单 11-5 中 的 Rule 类 提 
供 了 对 每 条 规则 的 简要 解释 ， 如 图 11-24 所 示 。 在 运行 这 个 程序 的 时 候 ， 从 左 到 右 地 移动 
Alpha 滑动 条 ， 就 可 以 观察 到 所 产生 的 组 合 形状 的 效果 。 特 别 是 ， 请 注意 DST_IN 与 DST_ 
OUT 规则 之 间 唯 一 的 差别 ， 那 就 是 ， 当 你 改变 源 像素 的 透明 度 值 时 ， 目 标 (! ) 颜色 将 会 发 
生 什 么 样 的 变化 。 





图 11-24 CompositeTest 程序 运行 的 结果 
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package composite; 


import java.awt.*; 


import javax.swing.*: 


/* 


C 


{ 


* This frame contains a combo box to choose a composition rule, a slider to change the source 
* alpha channel, and a component that shows the composition. 

Fi 

lass CompositeTestFrame extends JFrame 


private static final int DEFAULT_WIDTH = 400; 
private static final int DEFAULT_HEIGHT = 400; 


private CompositeComponent canvas; 
private JComboBox<Rule> ruleCombo; 
private JSlider alphaSlider; 
private JTextField explanation; 


public CompositeTestFrame() 


{ 
setSize(DEFAULT_WIDTH, DEFAULT_HEIGHT) ; 


canvas = new CompositeComponent () ; 
add(canvas, BorderLayout. CENTER) ; 


ruleCombo = new JComboBox<>(new Rule[] { new Rule("CLEAR", " "|" "), 
new Rul e("SRC", "n Sr " $") i new Rul e("DST", " "4 "DD") i 
new Rule("SRC_OVER", " S", "DS"), new Rule("DST_OVER", " S", "DD"), 


new Rule("SRC_IN", " ", " S"), new Rule("SRC_OUT", " S$",." "), 
new Rule("DST_IN", " " " D"), new Rule("DST_OUT", " ", "D"), 
new Rule("SRC_ATOP", " E , "DS"), new Rule("DST_ATOP", 3 om " D*); 


new Rule("XOR", 时 s", "D 中 }); 
ruleCombo.addActionListener(event -> 


Rule r = (Rule) ruleCombo.getSelectedItem() ; 
canvas. setRule(r.getValue()); 
explanation. setText(r.getExplanation()); 


H; 


alphaSlider = new JSlider(0, 100, 75); 

alphaSlider.addChangeListener(event -> canvas. setAlpha(alphaSlider.getValue())); 
JPanel panel = new JPanel(); 

panel .add(ruleCombo) ; 

panel .add(new JLabel ("Alpha")); 

panel .add(alphaSlider); 

add(panel, BorderLayout.NORTH) ; 


explanation = new JTextField(); 
add(explanation, BorderLayout. SOUTH) ; 


canvas. setAl pha(alphaSlider.getValue()); 
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15 


} 


Rule r = ruleCombo.getItemAt (ruleCombo.getSelectedIndex()) ; 
canvas. setRule(r.getValue()); 
explanation. setText(r.getExplanation()) ; 


package composite; 


import java.awt.*; 
import java.awt.geom.*; 
import java.awt.image.*; 
import javax.swing.*; 


/** 


* This component draws two shapes, composed with a composition rule. 


a} 


class CompositeComponent extends JComponent 


{ 


private int rule; 

private Shape shapel; 
private Shape shape2; 
private float alpha; 


public Composi teComponent () 


{ 


} 


shapel = new Ellipse2D.Double(100, 100, 150, 100); 
shape2 = new Rectangle2D.Double(150, 150, 150, 100); 


public void paintComponent (Graphics g) 


} 


/** 


* 
* 
* 


Graphics2D g2 = (Graphics2D) g; 


BufferedImage image = new BufferedImage(getWidth(), getHeight(), 
BufferedImage. TYPE_INT_ARGB) ; 

Graphics2D gImage = image.createGraphics(); 

gImage.setPaint (Color. red) ; 

gImage. fi 11 (shape) ; 

AlphaComposite composite = AlphaComposite.getInstance(rule, alpha) ; 

gImage. setComposi te (composi te) ; 

gImage.setPaint(Color.blue) ; 

gImage. fi 11 (shape2) ; 

g2.drawImage(image, null, 0, 0); 


Sets the composition rule. 
@param r the rule (as an AlphaComposite constant) 


public void setRule(int r) 


{ 


rule = r; 





Re 11 # 


BA AWT 655 





656 Java SHR All RAJH 


47 repaint(); 

48 

49 

50 /** 

51 * Sets the alpha of the source. 

52 * @aram a the alpha value between 0 and 100 
53 */ 


54 public void setAlpha(int a) 


{ 
56 alpha = (float) a / 100.0F; 
57 repaint(); 





1 package composite; 

2 

3 Import java.awt.*: 

4 

5 /** 

6 * This class describes a Porter-Duff rule. 
? 党 

8 class Rule 

9 { 

10 private String name; 

11 private String porterDuff1; 
12 private String porterDuff2; 


14 /** 
15 * Constructs a Porter-Duff rule. 
16 * @param n the rule name 


17 * @aram pdl the first row of the Porter-Duff square 
18 * @aram pd2 the second row of the Porter-Duff square 
* 


20 public Rule(String n, String pd1, String pd2) 
{ 


22 name = n; 
23 porterDuffl = pd1; 

24 porterDuff2 = pd2; 

25 } 

26 

27 /** 

28 * Gets an explanation of the behavior of this rule. 
29 * @return the explanation 

30 */ 


31 public String getExplanation() 
{ 


33 StringBuilder r = new StringBuilder("Source "); 

34 if (porterDuff2.equals(" ")) r.append("clears"); 

35 if (porterDuff2.equals(" S")) r.append("overwrites"); 

36 if (porterDuff2.equals("DS")) r.append("blends with"); 

37 if (porterDuff2.equals(" D")) r.append("alpha modifies"); 


38 if (porterDuff2.equals("D ")) r.append("alpha complement modifies"); 
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39 if (porterDuff2.equals("DD")) r.append("does not affect"); 

40 r.append(" destination"); 

41 if (porterDuffl.equals(" S")) r.append(" and overwrites empty pixels"); 
42 r.append("."); 

43 return r.toString(); 

4  } 

45 

46 public String toString() 

47 { 

48 return name; 

49 } 

50 

51 /** 

52 * Gets the value of this rule in the AlphaComposite class. 

53 * @return the AlphaComposite constant value, or -1 if there is no matching constant 
54 */ 

ss public int getValue() 

56 { 

57 try 

58 { 

59 return (Integer) AlphaComposite.class.getField(name) .get(nul1); 
60 

61 catch (Exception e) 

62 

63 return -1; 





e void setComposite(Composite s) 


把 图 形 上 下 文 的 组 合 方式 设置 为 实现 了 Composite 接口 的 给 定 对 象 。 





e static AlphaComposite getInstance(int rule) 


e static AlphaComposite getInstance(int rule, float sourceAlpha) 


构建 一 个 透明 度 (alpha) 值 的 组 合 对 象 。 规 则 是 CLEAR, SRC, SRC_OVER, DST_ 
OVER, SRC_IN, SRC_OUT, DST_IN, DST_OUT, DST, DST_ATOP, SRC_ATOP, 


XOR 等 值 之 一 o 


11.9 绘图 提示 


在 前 面 的 小 节 中 ， 已 经 看 到 了 绘图 过 程 是 非常 复杂 的 。 虽 然 在 大 多 数 情况 下 Java 2D API 
的 运行 速度 奇 快 ， 但 是 在 某 些 情况 下 ， 你 可 能 希望 控制 绘图 的 速度 和 质量 之 间 的 平衡 关系 。 
可 以 通过 设置 绘图 提示 来 达到 此 目的 。 使 用 Graphics2D 类 的 setRenderingHint 方法 ， 
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可 以 设置 一 条 单一 的 绘图 提示 ， 提 示 的 键 和 值 是 在 RenderingHints 类 中 声明 的 。 表 11-2 
汇总 了 可 以 使 用 的 选项 。 以 _DEFAULT 结尾 的 值 表示 某 种 特定 实现 将 其 作为 性 能 与 质量 之 间 
的 良好 平衡 而 所 选择 的 默认 值 。 


表 11-2 绘图 提示 





键 值 解释 
KEY_ANTIALIASING VALUE_ANTIALIAS_ON 打开 或 者 关闭 形状 的 消除 图 形 锯 齿 状 
VALUE_ANTIALIAS_OFF 的 特性 

VALUE_ANTIALIAS_DEFAULT 
KEY_TEXT_ANTIALIASING VALUE_TEXT_ANTIALIAS_ON 打开 或 者 关闭 字体 的 消除 图 形 锯 齿 状 
VALUE_TEXT_ANTIALIAS_OFF 的 特性 。 当 使 用 VALUE_ TEXT _ANTI- 


VALUE_TEXT_ANTIALIAS_DEFAULT ALIAS_ GASP 这 个 值 时 ， 会 查询 字体 
VALUE_TEXT_ANTIALIAS_GASP 6 “派生 表 ” 以 确定 字体 的 某 种 特定 字号 是 
VALUE_TEXT_ANTIALIAS_LCD_HRGB 6 否 应 该 消除 图 形 的 锯齿 状 。LCD 值 强制 
VALUE_TEXT_ANTIALIAS_LCD_HBGR 6 对 某 种 特定 显示 类 型 进行 子 像素 绘制 
VALUE_TEXT_ANTIALIAS_LCD_VRGB 6 

VALUE_TEXT_ANTIALIAS_LCD_VBGR 6 


KEY_FRACTIONALMETRICS VALUE_FRACTIONALMETRICS_ON 打开 或 者 关闭 小 数字 符 尺 寸 计算 的 功 


VALUE_FRACTIONALMETRICS_OFF 能 。 使 用 小 数字 符 尺 寸 的 计算 功能 ， 将 
VALUE_FRACTIONALMETRICS_ 会 更 好 地 安排 字符 的 位 置 


DEFAULT 
KEY_RENDERING VALUE_RENDER_QUALITY 当 其 可 用 时 ， 选 定 相 应 的 绘图 算法 ， 
VALUE_RENDER_SPEED 以 便 获 得 更 高 的 质量 或 速度 
VALUE_RENDER_DEFAULT 
KEY_STROKE_CONTROL 1.3 VALUE_STROKE_NORMALIZE 选 定 笔划 的 位 置 是 由 图 形 加 速 器 ( 它 
VALUE_STROKE_PURE 也 许 会 将 笔划 的 位 置 调整 最 多 半 个 像素 ) 
VALUE_STROKE_DEFAULT 控制 ， 还 是 由 强制 笔划 穿越 像素 中 心 的 
“ 纯 ” 规 则 计算 出 来 
KEY_DITHERING VALUE_DITHER_ENABLE 打开 或 者 关闭 颜色 的 浓淡 处 理 功 能 。 
VALUE_DITHER_DISABLE 通过 绘制 相似 颜色 的 许多 像素 组 ， 浓 淡 
VALUE_DITHER_DEFAULT 处 理 功能 就 可 以 确定 颜色 的 近似 值 。( 注 
意 ， 消 除 锯齿 功能 可 能 会 与 浓淡 处 理 功 
能 相干 ) 
KEY_ALPHA_INTERPOLATION ”VALUE_ALPHA_INTERPOLATION_ 打开 或 者 关闭 透明 度 (alpha) 值 组 合 的 
QUALITY 精确 计算 功能 
VALUE_ALPHA_INTERPOLATION_ 
SPEED 
VALUE_ALPHA_INTERPOLATION_ 
DEFAULT 
KEY_COLOR_RENDERING VALUE_COLOR_RENDER_QUALITY 选 定 颜色 泻 染 的 质量 或 速度 。 只 有 在 
VALUE_COLOR_RENDER_SPEED 使 用 了 不 同 的 颜色 空间 时 ， 才 会 涉及 此 
VALUE_COLOR_RENDER_DEFAULT 问题 
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(  ) 
键 值 fe g 
KEY_INTERPOLATION VALUE_INTERPOLATION_NEAREST_. 当 对 形状 进行 缩放 或 者 旋转 操作 时 ， 
NEIGHBOR 为 像素 的 插 换 选择 一 个 规则 


VALUE_INTERPOLATION_BILINEAR 
VALUE_INTERPOLATION_BICUBIC 


这 些 设 置 中 最 有 用 的 是 消除 图 形 锯齿 现象 的 技术 ， 这 种 技术 消除 了 和 斜 线 和 曲线 中 的 “ 饥 
齿 ”(jaggies)。 正 如 在 图 11-25 所 见 的 那样 ， 
斜 线 必须 被 绘制 成 为 一 个 像素 的 “阶梯 ”。 特 
别 是 在 低 分 辩 率 的 显示 屏 上 ， 你 所 画 的 线条 将 
非常 难看 。 但 是 ， 如 果 不 是 完整 地 绘制 或 排除 
每 一 个 像素 ， 而 是 在 线条 所 和 覆盖 的 像素 中 ， 用 
与 被 覆盖 区 域 成 比例 的 颜色 ， 来 着 色 被 部 分 覆 
盖 的 元 素 ， 那 么 所 产生 的 线条 看 上 去 就 要 平 请 
得 多 。 这 种 技术 被 称 为 “消除 图 形 锯齿 状 ” 技 
术 。 当 然 ， 使 用 这 种 技术 所 花费 的 时 间 要 长 一 
些 ， 因 为 它 需要 花 一 定 的 时 间 去 计算 所 有 这 些 
颜色 的 值 。 

例如 ， 下 面 的 代码 说 明了 应 该 如 何 请 求 使 用 消除 图 形 锯齿 状 功 能 。 


g2.setRenderingHint (RenderingHints.KEY_ANTIALIASING, RenderingHints.VALUE_ANTIALIAS_ON) ; 


使 用 消除 图 形 锯齿 状 技术 对 字体 的 绘制 同样 是 有 意义 的 。 


g2.setRenderingHint (RenderingHints.KEY_TEXT_ANTIALIASING, 
RenderingHints.VALUE_TEXT_ANTIALIAS_ON) ; 


和 上 面 的 这 些 应 用 相 比 较 ， 其 他 的 绘图 提示 并 不 是 很 常用 。 

可 以 把 一 组 键 / 值 提示 信息 对 放 和 人 映射 表 中 ， 并 且 通 过 调用 setRenderingHints 方法 
一 次 性 地 将 它们 全 部 设置 好 。 也 可 以 使 用 任何 实现 了 映射 表 接 口 的 集合 类 ， 当 然 还 可 以 使 用 
RenderingHints 类 本 身 ， 它 实现 了 Map 接口 ， 并 且 在 用 无 参数 的 构造 器 来 创建 对 象 时 ， 它 
会 提供 一 个 默认 的 映射 表 实 现 。 例 如 ， 


RenderingHints hints = new RenderingHints(nul1) ; 
hints.put(RenderingHints.KEY_ANTIALIASING, RenderingHints.VALUE_ ANTIALIAS _ON) ; 
hints.put(RenderingHints.KEY_TEXT_ANTIALIASING, RenderingHints.VALUE_TEXT_ANTIALIAS_ON) ; 
g2.setRenderingHints (hints) ; 


这 就 是 我 们 在 程序 清单 11-6 中 使 用 的 技术 。 该 程序 展示 了 几 种 我 们 认为 会 提供 帮助 的 给 
图 提示 。 注 意 下 面 几 点 : 

o 消除 锯齿 功能 使 椭圆 变 得 平滑 。 

o 文本 的 消除 锯齿 功能 使 文本 变 得 平滑 。 

o 在 某 些 平台 上 ， 值 为 小 数 的 文本 距离 会 使 字母 之 间 彼 此 靠 得 更 近 一 些 。 





图 11-25 ”消除 图 形 锯齿 现象 的 示意 图 
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e 选 择 VALUE_RENDER_QUALITY 来 平滑 缩放 的 图 像 。( 通 过 将 KEY_INTERPOLATION 设 
置 为 VALUE_INTERPOLATION_BICUBIC 可 以 达到 相同 的 效果 )。 


o 当 消 除 锯齿 功能 关闭 时 ， 选 择 VALUE_STROKE_NORMALIZE 会 改变 椭圆 的 外 观 和 正方 
形 对 角 线 的 位 置 。 
图 11-26 显示 了 运行 该 程序 时 所 截取 的 一 个 屏幕 。 





图 11-26 绘图 提示 测试 程序 的 效果 





package renderQuality; 


import java.awt.*: 
import java.awt. geom. *; 


import javax.swing.*; 


/** 

* This frame contains buttons to set rendering hints and an image that is drawn with the selected 
* hints. 

u */ 

12 public class RenderQualityTestFrame extends JFrame 

B { 

14 private RenderQualityComponent canvas; 

15 private JPanel buttonBox; 

16 private RenderingHints hints; 

17 private int r; 


DD oo N Ao oo 和 wu N pm 


ran 
o 


E AEIR PERENE, POE SE ES E AERES SI TEP N E IE NE TEENE EE OR EN 


19 public RenderQualityTestFrame() 


20 { 

21 buttonBox = new JPanel (); 

22 buttonBox.setLayout (new GridBagLayout()) ; 

23 hints = new RenderingHints (null); 

24 

25 makeButtons("KEY_ANTIALIASING", "VALUE_ANTIALIAS OFF", "VALUE_ANTIALIAS ON"); 

26 makeButtons("KEY_TEXT_ANTIALIASING", "VALUE_TEXT_ANTIALIAS OFF", "VALUE_TEXT_ANTIALIAS. ON"); 
27 makeButtons ("KEY_FRACTIONALMETRICS", "VALUE_FRACTIONALMETRICS OFF", 

28 "VALUE_FRACTIONALMETRICS_ ON") ; 

29 makeButtons("KEY_RENDERING", "VALUE_RENDER_SPEED", "VALUE_RENDER QUALITY") ; 

30 makeButtons ("KEY_STROKE_CONTROL", "VALUE_STROKE_PURE", "VALUE_STROKE_NORMALIZE") ， 
31 canvas = new RenderQualityComponent() ; 

32 canvas. SetRenderingHints (hints) ; 


“Sica SES Se aa RE LS RD AS 


$ 
i 
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add(canvas, BorderLayout.CENTER) ; 
add(buttonBox, BorderLayout.NORTH) ; 
pack() ; 

} 


/** 
* Makes a set of buttons for a rendering hint key and values. 
* @param key the key name 
* @param valuel the name of the first value for the key 
* @aram value2 the name of the second value for the key 
* 
/ 
void makeButtons (String key, String valuel, String value2) 
{ 
try 
{ 
final RenderingHints.Key k = 
(RenderingHints.Key) RenderingHints.class.getField(key).get (null); 
final Object vl = RenderingHints.class.getField(valuel) .get (null); 
final Object v2 = RenderingHints.class.getField(value2) .get (null); 
JLabel label = new JLabel (key); 


buttonBox.add(label, new GBC(0, r).setAnchor(GBC.WEST)); 
ButtonGroup group = new ButtonGroup() ; 
JRadioButton bl = new JRadioButton(valuel, true); 


buttonBox.add(b1, new GBC(1, r).setAnchor(GBC.WEST)) ; 
group.add(b1) ; 
bl.addActionListener(event -> 


{ 
hints.put(k, v1); 
canvas. setRenderingHints (hints) ; 
H 
JRadioButton b2 = new JRadioButton(value2, false); 
buttonBox.add(b2, new GBC(2, r).setAnchor(GBC.WEST)) ; 
group.add(b2) ; 
b2.addActionListener(event -> 


hints.put(k, v2); 
canvas. setRenderingHints (hints) ; 


H; 
hints.put(k, v1); 
r++} 


catch (Exception e) 


e.printStackTrace() ; 
} 


/** 
* This component produces a drawing that shows the effect of rendering hints. 


"i 
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88 class RenderQualityComponent extends JComponent 

89 { 

90 private static final Dimension PREFERRED_SIZE = new Dimension(750, 150); 
91 private RenderingHints hints = new RenderingHints(null); 

92 private Image image; 


93 

94 public RenderQualityComponent () 

95 { 

96 image = new ImageIcon(getClass().getResource("face.gif")).getImage() ; 
97 } 

98 

99 public void paintComponent (Graphics g) 
100 { 

101 Graphics2D g2 = (Graphics2D) g; 

102 g2.setRenderingHints (hints) ; 

103 


104 g2.draw(new Ellipse2D.Double(10, 10, 60, 50)); 
105 g2.setFont(new Font("Serif", Font. ITALIC, 40)); 
106 g2.drawString("Hello", 75, 50); 


108 g2.draw(new Rectangle2D.Double(200, 10, 40, 40)); 
109 g2.draw(new Line2D.Double(201, 11, 239, 49)); 


110 

111 g2.drawImage(image, 250, 10, 100, 100, null); 
12 } 

113 

114  /** 


115 * Sets the hints and repaints, 

116 * @param h the rendering hints 

117 */ 

118 public void setRenderingHints(RenderingHints h) 
u9 { 

120 hints = h; 

121 repaint(); 





124 public Dimension getPreferredSize() { return PREFERRED SIZE; } 
125 } 








e void setRenderingHint(RenderingHints.Key key, Object value) : 
为 该 图 形 上 下 文 设置 绘图 提示 。 
e void setRenderingHints(Map m) 


设置 绘图 提示 ， 它 们 的 键 / 值 对 存储 在 映射 表 中 。 










s Render fro Ti Cues eRendarinalli nes. cay. "i m) 
构建 一 个 存放 绘图 提示 的 绘图 提示 映射 表 。 如 果 m 值 为 nu11， 那 么 将 会 提供 一 个 默认 
的 绘图 提示 映射 表 。 





#11 Ë BRAWT 663 


11.10 BRANNAN S ABS 


javax.imageio 包 包 含 了 对 读 取 和 写 人 数 种 常用 文件 格式 进行 支持 的 “附加 ”特性 。 
同时 还 包含 了 一 个 框架 ， 使 得 第 三 方 能 够 为 其 他 图 像 格式 的 文件 添加 读 取 顺 和 写 人 人 船 。GIF、 
JPEG, PNG, BMP (Windows 位 图 ) 和 WBMP (无 线 位 图 ) 等 文件 格式 都 得 到 了 文 持 。 

该 类 库 的 基本 应 用 是 极其 直接 的 。 要 想 装载 一 个 图 像 ， 可 以 使 用 ImageI0 类 的 静态 
read 方法 。 


Filefs,..; 
BufferedImage image = Imagel0.read(f) ; 


ImageI0 类 会 根据 文件 的 类 型 ， 选 择 一 个 合适 的 读 取 器 。 它 可 以 参考 文件 的 扩展 名 和 文 
件 开 头 的 专用 于 此 目的 的 “ 幻 数 ”( magic number) 来 选择 读 取 器 。 如 果 没 有 找到 合适 的 读 取 
器 或 者 读 取 器 不 能 解码 文件 的 内 容 ， 那 么 read 方法 将 返回 null, 

把 图 像 写 人 到 文件 中 也 是 一 样 地 简单 。 


Filefs, .,; 
String format=... .} 
Imagel0.write(image, format, f); 


这 里 ，format 字符 串 用 来 标识 图 像 的 格式 ， 比 如 “JPEG” 或 者 “PNG”。ImageI0 类 
将 选择 一 个 合适 的 写 人 器 以 存储 文件 。 


11.10.1 ”获得 适合 图 像 文件 类 型 的 读 取 器 和 写 入 器 


对 于 那些 超出 ImageI0 类 的 静态 read 和 write 方法 能 力 范围 的 高 级 图 像 读 取 和 写 入 
操作 来 说 ， 首 先 需要 获得 合适 的 ImageReader 和 ImageWriter 对 象 。ImageI0 类 枚 举 了 
匹配 下 列 条 件 之 一 的 读 取 硕 和 写 信 冀 。 

o 图 像 格式 (比如 “JPEG”) 

o 文件 后 级 (比如 “jpg”) 

e MIME 类 型 (比如 “image/jpeg”) 


注意 : MIME ( Multipurpose Internet Mail Extensions standard) 是 “多 用 途 因 特 网 邮件 
扩展 标准 ”的 英文 缩写 。MIME 标准 定义 了 常用 的 数据 格式 ， 比 如 “image/jpeg ”和 
“application/pdf” 等 。 


例如 ， 可 以 用 下 面 的 代码 来 获取 一 个 JPEG 格式 文件 的 读 取 右 。 


ImageReader reader = null; 
Iterator<ImageReader> iter = Imagel0.getImageReadersByFormatName ("JPEG") ; 
if (iter. hasNext()) reader = iter.next(); 


get ImageReadersBySuffix #il get ImageReadersByMIMEType 这 两 个 方法 用 于 枚 举 
与 文件 扩展 名 或 MIME 类 型 相 匹 配 的 读 取 胡 。 

ImageI0 类 可 能 会 找到 多 个 读 取 器 ， 而 它们 都 能 够 读 取 某 一 特殊 类 型 的 图 像 文件 。 在 这 
种 情况 下 ， 必 须 从 中 选择 一 个 ， 但 是 也 许 你 不 清楚 怎样 才能 选择 一 个 最 好 的 。 如 果 要 了 解 更 
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多 的 关于 读 取 器 的 信息 ， 就 要 获取 它 的 服务 提供 者 接口 : 
ImageReaderSpi spi = reader.getOriginatingProvider(); 


然后 ， 可 以 获得 供应 商 的 名 字 和 版 本 号 : 


String vendor = spi.getVendor(); 
String version = spi.getVersion(); 


也 许 该 信息 能 够 帮助 你 决定 选择 哪 一 种 读 取 器 ， 或 者 你 可 以 为 你 的 程序 用 户 提供 一 个 读 
取 需 的 列表 ， 让 他 们 做 出 选择 。 然 而 ， 目 前 来 说 ， 我 们 假定 第 一 个 列 出 来 的 读 取 器 就 能 够 满 
足 用 户 的 需求 。 

在 程序 清单 11-7 中 ， 我 们 想 查 找 所 有 可 获得 的 读 取 器 能 够 处 理 的 文件 的 所 有 后 级， 这 
样 我 们 就 可 以 在 文件 过 滤器 中 使 用 它们 。 我 们 可 以 使 用 静态 的 ImageI0. getReader— 
FileSuffixes 方法 来 达到 此 目的 : 


String[] extensions = ImageI0.getWriterFileSuffixes(); 
chooser. setFileFilter(new FileNameExtensionFilter("Image files", extensions)); 


对 于 保存 文件 ， 相 对 来 说 更 麻烦 一 些 : 我 们 希望 为 用 户 展示 一 个 支持 所 有 图 像 类 型 的 菜 
单 。 可 惜 ，I0Image 类 的 getWriterFormateNames 方法 返回 了 一 个 相当 奇怪 的 列表 ， 里 
边 包 含 了 许多 元 余 的 名 字 ， 比 如 : 

jpg, BMP, bmp, JPG, jpeg, wbmp, png, JPEG, PNG, WBMP, GIF, gif 


这 些 并 不 是 人 们 想 要 在 菜单 中 显示 的 东西 ， 我 们 所 需要 的 是 “首选 ”格式 名 列表 。 我 们 
提供 了 一 个 用 于 此 目的 的 助手 方法 getWriterFormats (参见 程序 清单 11-7 )。 我 们 查找 与 
每 一 种 格式 名 相关 的 第 一 个 写 人 器 ， 然 后， 询问 该 写 人 器 它 支持 的 格式 名 是 什么 ， 从 而 希望 
它 能 够 将 最 流行 的 一 个 格式 名 列 在 首位 。 实 际 上 ， 对 JPEG 写 入 器 来 说 ， 这 种 方法 确实 很 有 
效 : 它 将 “JPEG” 列 在 其 他 选项 的 前 面 。( 另 一 方面 ，PNG 写 人 器 把 小 写字 母 的 “png” 列 
在 “PNG” 的 前 面 。 我 们 希望 这 种 行为 能 够 在 将 来 的 某 个 时 候 得 以 解决 。 同 时 ， 我 们 强制 将 
全 小 写 名 字 转 换 为 大 写 )。 一 旦 挑选 了 首选 名 ,我 们 就 会 将 所 有 其 他 的 候选 名 从 最 初 的 名 字 
集中 移 除 。 之 后 ， 我 们 会 继续 执行 直至 所 有 的 格式 名 都 得 到 处 理 。 


11.10.22 读 取 和 写 入 带 有 多 个 图 像 的 文件 


有 些 文件 ， 特 别 是 GIF 动画 文件 ， 都 包含 了 多 个 图 像 。ImageI0 类 的 read 方法 只 能 够 
读 取 单个 图 像 。 为 了 读 取 多 个 图 像 ， 应 该 将 输入 源 (例如 ， 输 入 流 或 者 输入 文件 ) 转换 成 一 
个 ImageInputStream。 


InputStream in=.. .} 
ImageInputStream imageIn = ImageI0.createImageInputStream(in) ; 


RE ERRA Tie AB BUS IE ALR set Input 方法 : 

reader.setInput(imageIn, true); 

方法 中 的 第 二 个 参数 值 表示 输入 的 方式 是 “只 向 前 搜索 "， 否则， 就 采用 随机 访问 的 方 
HK, 要 么 是 在 读 取 时 缓冲 输入 流 ， 要 么 是 使 用 随机 文件 访问 。 对 于 某 些 操作 来 说 ， 必 须 使 用 
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随机 访问 的 方法 。 例 如 ， 为 了 在 一 个 GIF 文件 中 查寻 图 像 的 个 数 ， 就 需要 读 入 整个 文件 。 这 
时 ， 如 果 想 获取 某 一 图 像 的 话 ， 必 须 再 次 读 入 该 输入 文件 。 

只 有 当 从 一 个 流 中 读 取 图 像 ， 并 且 输 入 流 中 包含 多 个 图 像 ， 而 且 在 文件 头 中 的 图 像 格 式 
部 分 没有 所 需要 的 信息 (比如 图 像 的 个 数 ) 时 ， 考 虑 使 用 上 面 的 方法 才 是 合适 的 。 如 采 要 从 
一 个 文件 中 读 取 图 像 信 息 的 话 ， 可 直接 使 用 下 面 的 方法 : 


Filef=...,; 
ImageInputStream imageIn = Imagel0.createlmageInputStream(f) ; 
reader. setInput (imageln) ; 


一 日 拥有 了 一 个 读 取 器 后 ， 就 可 以 通过 调用 下 面 的 方法 来 读 取 输 入 流 中 的 图 像 。 
BufferedImage image = reader,read(index) ; 


其 中 index 是 图 像 的 索引 ， 其 值 从 0 开始 。 

如 果 输 入 流 采 用 “只 向 前 搜索 ”的 方式 ， 那 么 应 该 持续 不 断 地 读 取 图 像 ， 直 到 read 方 
法 抛 出 一 个 IndexOutOfBoundsException 为 止 。 否 则 ， 可 以 调用 getNumImages 方法 : 

int n = reader.getNumImages (true) ; 

在 该 方法 中 ， 它 的 参数 表示 允许 搜索 输入 流 以 确定 图 像 的 数目 。 如 果 输 入 流 采用 “只 加 
前 搜索 ”的 方式 ， 那 么 该 方法 将 抛 出 一 个 I1legalStateException 异常 。 要 不 然 ， 可 以 把 
是 否 “ 人 允许 搜索 ”参数 设置 为 false。 如 果 getNumImages 方法 在 不 搜索 输入 流 的 情况 下 无 
法 确定 图 像 的 数目 ， 那 么 它 将 返回 - 1。 在 这 种 情况 下 ， 必 须 转 换 到 B 方案 ， 那 就 是 持续 不 
断 地 读 取 图 像 ， 直 到 获得 一 个 Index0ut0fBoundsException 异常 为 止 。 

有 些 文件 包含 一 些 缩 略 图 ， 也 就 是 图 像 用 来 预览 的 小 版 本 。 可 以 通过 调用 下 面 的 方法 来 
获得 某 个 图 像 的 缩 略图 数量 。 


int count = reader,getNumThumbnai1s(index) ; 

然后 可 以 按 如 下 方式 得 到 一 个 特定 索引 : 

BufferedImage thumbnail = reader.getThumbnail (index, thumbnailIndex); 

另 一 个 问题 是 ， 有 时 你 想 在 实际 获得 图 像 之 前 ， 了 解 该 图 像 的 大 小 。 特 别 是 ， 当 图 像 很 
大 ， 或 者 是 从 一 个 较 慢 的 网 络 连 接 中 获取 的 时 候 ， 你 更 加 希望 能 够 事先 了 解 到 该 图 像 的 大 
小 。 那 么 请 使 用 下 面 的 方法 : 


int width = reader.getWidth(index) ; 
int height = reader.getHeight (index) ; 


通过 上 面 两 个 方法 可 以 获得 具有 给 定 索引 的 图 像 的 大 小 。 
如 果 要 将 多 个 图 像 写 入 到 一 个 文件 中 ， 首 先 需 要 一 个 Imagewriter。ImageI0 类 能 够 
REA WS ASR EE RRM TAS Ade o 


String format=... .; 

ImageWriter writer = null; 

Iterator<ImageWriter> iter = ImageI0.getImageWritersByFormatName (format) ; 
if (iter.hasNext()) writer = iter.next(); 
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接着 ， 将 一 个 输出 流 或 者 输出 文件 转换 成 Image0utputStream， 并 且 将 其 作为 参数 传 
给 写 人 器 。 例 如 ， 


Pile-F si.2. is 
ImageQutputStream imageQut = Imagel0.createImageQutputStream(f) ; 
writer.setQutput (imageQut) ; 


必须 将 每 一 个 图 像 都 包装 到 II0Image 对 象 中 。 可 以 根据 情况 提供 一 个 缩 略图 和 图 像 元 
数据 (比如 ， 图 像 的 压缩 算法 和 颜色 信息 ) 的 列表 。 在 本 例 中 ， 我们 把 两 者 都 设置 为 nu11 ; 
如 果 要 了 解 详细 信息 ， 请 参阅 API 文档 。 


IIOImage iioImage = new IIOImage(images[i], nul], null); 
使 用 write 方法 ， 可 以 写 出 第 一 个 图 像 : 
writer.write(new IIOImage(images[0] null, null)); 


对 于 后 续 的 图 像 ， 使 用 下 面 的 方法 : 


if (writer.canInsertImage(i)) 
writer.writeInsert(i, iioImage, null); 


上 面 方法 中 的 第 三 个 参数 可 以 包含 一 个 
ImageWriteParam 对 象 ， 用 以 设置 图 像 写 人 的 详 
细 信 息 ， 比 如 是 平 铺 还 是 压缩 ; 可 以 用 null 作为 其 
默认 值 。 

并 不 是 所 有 的 图 像 格式 都 能 够 处 理 多 个 图 像 。 
在 这 种 情况 下 ， 如 果 i>o, canInsertImage 方法 
将 返回 false 值 ， 而 且 只 保存 单一 图 像 。 

程序 清单 11-7 中 的 程序 使 用 Java 类 库 所 提供 
的 读 取 需 和 写 人 器 支持 的 格式 来 加 载 和 保持 文件 。 
该 程序 显示 了 多 个 图 像 ( 见 图 11-27 )， 但 是 没有 缩 
略图 。 









package imagel0; 
import java.awt.image.*; 


import java.i0.*; 
import java.util.*; 


import javax.imageio.*; 

import javax.imageio. stream. *: 
import javax.swing.*; 

10 import javax.swing.filechooser.*; 


oe ē N DKD” a A u N Fa 


13 * This frame displays the loaded images. The menu has items for loading and saving files. 
14 */ 
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is public class ImageIOFrame extends JFrame 


16 { 

7 private static final int DEFAULT_WIDTH = 400; 

18 private static final int DEFAULT_HEIGHT = 400; 

20 private static Set<String> writerFormats = getWriterFormats () ; 


22 private BufferedImage(] images; 


24 public Imagel0Frame() 


25 { 

26 setSize(DEFAULT_WIDTH, DEFAULT_HEIGHT) ; 

27 

28 JMenu fileMenu = new JMenu("File"); 

29 JMenuItem openItem = new JMenultem("Open") ; 

30 openItem. addActionListener(event -> openFile()); 

31 fi leMenu.add(openItem) ; 

32 

33 JMenu saveMenu = new JMenu("Save") ; 

34 fi leMenu.add(saveMenu) ; 

35 Iterator<String> iter = writerFormats.iterator() ; 

36 while (iter. hasNext()) 

37 { 

38 final String formatName = iter.next(); 

39 JMenuItem formatItem = new JMenuItem(formatName) ; 
40 saveMenu. add(formatItem) ; 

41 formatItem.addActionListener(event -> saveFile(formatName)) ; 
42 } 

43 

44 JMenultem exitItem = new JMenuItem("Exit") ; 

45 exitItem.addActionListener(event -> System.exit(0)); 
46 fileMenu.add(exitItem) ; 

47 

48 JMenuBar menuBar = new JMenuBar(); 

49 menuBar.add(fi]eMenu) ; 

50 setJMenuBar (menuBar) ; 

51 } 

52 

53 /** 

54 * Open a file and load the images. 

55 */ 

56 public void openFile() 

57 { 

58 JFileChooser chooser = new JFileChooser(); 

59 chooser. setCurrentDi rectory(new File(".")); 

60 String[] extensions = Imagel0.getReaderFileSuffixes() ; 
61 chooser. setFileFilter(new FileNameExtensionFilter("Image files", extensions)); 
62 int r = chooser. showOpenDialog(this) ; 

63 if (r != JFileChooser.APPROVE_OPTION) return; 

64 File f = chooser.getSelectedFile() ; 

65 Box box = Box.createVertical Box() ; 

66 try 

67 { 


68 String name = f.getName() ; 
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69 String suffix = name.substring(name.]astIndex0f('.') + 1): 

70 Iterator<ImageReader> iter = ImageI0.getImageReadersBySuffi x (suffix) ; 

71 ImageReader reader = iter.next(); 

72 ImageInputStream imageIn = ImageI0.createImageInputStream(f) ; 

73 reader. setInput (imageIn) ; 

74 int count = reader. getNumImages (true) ; 

75 images = new BufferedImage [count] ; 

76 for (int i = 0; i < count; i++) 

77 

78 images[i] = reader. read(i); 

79 box.add(new JLabel (new ImageIcon(images[i]))); 

80 } 

81 

82 catch (IOException e) 

83 { 

84 JOptionPane.showMessageDialog(this, e); 

85 

86 setContentPane(new JScrol]Pane(box)); 

87 validate(); 

88 } 

89 

90 /** 
91 * Save the current image in a file. f 
92 * @param formatName the file format : 
93 */ 
% public void saveFile(final String formatName) a 
5 è { : 
96 if (images == null) return; 
97 Iterator<ImageWriter> iter = ImageI0.getImageWritersByFormatName(formatName) : 
98 ImageWriter writer = iter.next(); 
99 ]FileChooser chooser = new JFileChooser(); 
100 chooser. setCurrentDirectory(new File(".")); 
101 String[] extensions = writer.getOriginatingProvider() .getFileSuffixes() ; : 
102 chooser. setFileFilter(new FileNameExtensionFilter("Image files", extensions)): 
103 

104 int r = chooser. showSaveDialog(this) ; 

105 if (r != JFileChooser.APPROVE_OPTION) return: 

106 File f = chooser.getSelectedFile(); 

107 try 

108 { 

109 ImageOutputStream imageOut = ImageI0.createImageQutputStream(f) ; 

110 writer. setOutput (imageQut) ; 

111 

112 writer.write(new IIOImage(images[0] null, null)): 

113 for (int i = 1; i < images.length; i++) 

114 

115 IIOImage 110Image = new IIOImage(images[i] null, null); 

116 if (writer.canInsertImage(i)) writer.writeInsert(i, iioImage, null); 

117 } 

118 

119 catch (IOException e) 

120 

121 JOptionPane.showMessageDialog(this, e); 


122 } 
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13 } 


aa be 

126 * Gets a set of "preferred" format names of all image writers. The preferred format name is 
127 * the first format name that a writer specifies. 

128 * @return the format name set 

129 */ 

130 public static Set<String> getWriterFormats () 

B31 { 


132 Set<String> writerFormats = new TreeSet<>() ; 

133 Set<String> formatNames = new TreeSet<>( 

134 Arrays.asList (Imagel0.getWriterFormatNames())) ; 

135 while (formatNames.size() > 0) 

136 { 

137 String name = formatNames.iterator() .next(); 

138 Iterator<ImageWriter> iter = Imagel0.getImageWritersByFormatName (name) ; 
139 ImageWriter writer = iter.next(); 

140 String[] names = writer.getOriginatingProvider() .getFormatNames () ; 

141 String format = names [0] ; 

142 if (format.equals(format.toLowerCase())) format = format. toUpperCase() ; 
143 writerFormats.add(format) ; 

144 formatNames . removeAl | (Arrays.asList(names)) ; 

145 } 

146 return writerFormats; 

wo  } 

148 } 









e static BufferedImage read(File input) 
e static BufferedImage read( InputStream input) 
e static BufferedImage read(URL input) 
从 input 中 读 取 一 个 图 像 。 
e static boolean write(RenderedImage image, String formatName, File output) 
e static boolean write(RenderedImage image, String formatName, OutputStream 
output ) 
将 给 定格 式 的 图 像 写 人 output 中 。 如 果 没 有 找到 合适 的 写 入 器 ， 则 返回 false, 
e static Iterator<ImageReader> getImageReadersByFormatName(String formatName ) 
e static Iterator<ImageReader> getImageReadersBySuffix(String fileSuffix) 
e static Iterator<ImageReader> getImageReadersByMIMEType(String mimeType ) 
e static Iterator<ImageWriter> getImageWritersByFormatName(String formatName ) 
e static Iterator<ImageWriter> getImageWritersBySuffix(String fileSuffix) 
e static Iterator<ImageWriter> getImageWritersByMIMEType(String mimeType) 
获得 能 够 处 理 给 定格 式 (例如 “JPEG”)、 文 件 后 缀 (例如 “jpg”) 或 者 MIME 类 型 
(例如 “image/jpeg”) WIA RERA ME AA o 
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e static String[] getReaderFormatNames( ) 
e static String[] getReaderMIMETypes( ) 
e static String[] getWriterFormatNames() 
e static String[] getWriterMIMETypes() 
e static String[] getReaderFileSuffixes() 6 
e static String[] getWriterFileSuffixes() 6 

PAGE Da AG A tit BT CFE AY TA th. MIME 类 型 名 和 文件 后 缀 。 
e ImageInputStream createImageInputStream(Object input) 
e ImageOutputStream createImageOutputStream(Object output) 
根据 给 定 的 对 象 来 创建 一 个 图 像 输入 流 或 者 图 像 输出 流 。 该 对 象 可 能 是 一 个 文件 、 一 
个 流 、 一 个 RandomAccessFile 或 者 某 个 服务 提供 商 能 够 处 理 的 其 他 类 型 的 对 象 。 如 
采 没 有 任何 注册 过 的 服务 提供 器 能 够 处 理 这 个 对 象 ， 那 么 返回 null 值 。 





e void setInput(Object input) 
e void setInput(Object input, boolean seekForwardOnly) 
WEBER AHA 
参数 : input 一 个 ImageInputStream 对 象 或 者 是 这 个 读 取 器 能 够 接 
受 的 其 他 对 象 
seekForwardOnly 如 果 读 取 需 只 应 该 向 前 读 取 ， 则 返回 true。 默 认 地 ， 读 
取 何 会 采用 随机 访问 的 方式 ， 如 果 有 必要 ， 将 会 缓存 图 像 
数据 
e BufferedImage read(int index) 
读 取 给 定 索引 的 图 像 (索引 从 0 开始 )。 如 果 没 有 这 个 图 像 ， 则 抛 出 一 个 Indexoutof 
BoundsException 异常 。 
èe int getNumImages(boolean allowSearch) 
获取 读 取 器 中 图 像 的 数目 。 如 果 allowSearch {AW false, 并且 不 向 前 阅读 就 无 法 
确定 图 像 的 数目 ， 那 么 它 将 返回 1。 如果 a11owSearch 值 是 true， 并 且 读 取 器 采 
用 了 “只 回 前 搜索 ”方式 ， 那 么 就 会 抛 出 IT11ega1StateException 异常 。 
è int getNumThumbnails(int index) 
获取 给 定 索 引 的 图 像 的 缩 略 图 的 数量 。 
e BufferedImage readThumbnail(int index, int thumbnail Index) 
获取 给 定 索 引 的 图 像 的 索引 号 为 thumbnail Index 的 缩 略 图 。 
e int getWidth(int index) 
e int getHeight(int index) 
获取 图 像 的 宽度 和 高 度 。 如 果 没 有 这 样 的 图 像 ， 就 抛 出 一 个 Index0ut0fBounds- 
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Exception 异常 。 
e ImageReaderSpi getOriginatingProvider() 


获取 构建 该 读 取 器 的 服务 提供 者 。 





e String getVendorName( ) 
e String getVersion() 
获取 该 服务 提供 者 的 提供 商 的 名 字 和 版 本 。 





e String[] getFormatNames( ) 
e StringL] getFilesuffixes() 
e StringL] getMIMETypes( ) 


获取 由 该 服务 提供 者 创建 的 读 取 器 或 者 写 入 器 所 支持 的 图 像 格 式 名 、 文 件 的 后 缀 和 
MIME 类 型 。 





e void setOutput(Object output) 
设置 该 写 和 器 的 输出 目标 。 
参数 : output ”一 个 ImageOutputSteam 对 象 或 者 这 个 写 人 器 能 够 接受 的 其 他 对 象 。 
e void write(IIOImage image) 
e void write(RenderedImage image) 
把 单一 的 图 像 写 人 到 输出 流 中 。 
e void writeInsert(int index, IIOImage image, ImageWriteParam param) 
把 一 个 图 像 写 人 到 一 个 包含 多 个 图 像 的 文件 中 。 
e boolean canInsertImage(int index) 
如 果 在 给 定 的 索引 处 可 以 插入 一 个 图 像 的 话 ， 则 返回 true fH. 
e ImageWriterSpi getOriginatingProvider( ) 
获取 构建 该 写 信 器 的 服务 提供 者 。 








e IIOImage(RenderedImage image, List thumbnails, IIOMetadata metadata) 
根据 一 个 图 像 、 可 选 的 缩 略 图 和 可 选 的 元 数据 来 构建 一 个 IIOImage 对 象 。 


11.11 图像 处 理 
假设 你 有 一 个 图 像 ， 并 且 希 望 改善 图 像 的 外 观 。 这 时 需要 访问 该 图 像 的 每 一 个 像素 ， 并 
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用 其 他 的 像素 来 取代 这 些 像 素 。 或 者 ， 你 也 许 想 要 从 头 计 算 某 个 图 像 的 像素 ， 例 如 ， 你 想 显 
不 一 下 物理 测量 或 者 数学 计算 的 结果 。BufferedImage 类 提供 了 对 图 像 中 像素 的 控制 能 力 ， 
而 实现 了 BufferedImageOP 接口 的 类 都 可 以 对 图 像 进行 变换 操作 。 


注意 : JDK1.0 有 一 个 完全 不 同 且 复杂 得 多 的 图 像框 架 ， 它 得 到 了 优化 ， 以 支持 对 从 Web 
下 载 的 图 像 进 行 增 量 泻 染 (incremental rendering)， 即 一 次 绘制 一 个 扫描 行 。 但 是 ， 操 作 
这 些 图 像 很 困难 。 我 们 在 本 书 中 不 讨论 这 个 框架 。 


11.11.1 构建 光栅 图 像 


你 处 理 的 大 多 数 图 像 都 是 直接 从 图 像 文件 中 读 人 的 。 这 些 图 像 有 的 可 能 是 数码 相机 产生 
的 ， 有 的 是 扫描 仪 扫描 而 产生 的 ， 还 有 的 一 些 图 像 是 绘图 程序 产生 的 。 在 本 节 中 ， 我 们 将 介 
绍 一 种 不 同 的 构建 图 像 技 术 ， 也 就 是 每 次 为 图 像 增加 一 个 像素 。 

为 了 创建 一 个 图 像 ， 需 要 以 通常 的 方法 构建 一 个 BufferedImage 对 象 : 

image = new BufferedImage(width, height, BufferedImage,TYPE_INT_ARGB); 


现在 ， 调 用 getRaster 方法 来 获得 一 个 类 型 为 WritableRaster 的 对 象 ， 后 面 将 使 用 
这 个 对 象 来 访问 和 修改 该 图 像 的 各 个 像素 ; 


WritableRaster raster = image.getRaster(); 


使 用 setPixel 方法 可 以 设置 一 个 单独 的 像素 。 这 项 操作 的 复杂 性 在 于 不 能 只 是 为 该 像 
素 设 置 一 个 Color 值 ， 还 必须 知道 存放 在 缓冲 中 的 图 像 是 如 何 设 定 颜 色 的 ， 这 依赖 于 图 像 的 
类 型 。 如 果 图 像 有 一 个 TYPE_INT_ARGB 类 型 ， 那么 每 一 个 像素 都 用 四 个 值 来 描述 ， 即 : 红 、 
绿 、 蓝 和 透明 度 (alpha)， 每 个 值 的 取 值 范围 都 介 于 0 和 255 之 间 ， 这 需要 以 包含 四 个 整数 
值 的 一 个 数组 的 形式 给 出 : 


int[] black = { 0, 0, 0, 255 }: 
raster.setPixel(i, j, black); 


FA Java 2D API 的 行 话 来 说 ， 这 些 值 被 称 为 像素 的 样本 值 。 


O BS: 还 有 一 些 参数 值 是 float[] 和 doub1le[] 类 型 的 setPixel 方法 。 然 而 ， 需 要 在 
这 些 数组 中 放置 的 值 并 不 是 介 于 0.0 和 1.0 之 间 的 规格 化 的 颜色 值 


float[] red = { 1.0F, 0.0F, 0.0F, 1.0F }; 
raster.setPixel(i, j, red); // ERROR 


无 论 数组 属于 什么 类 型 ， 都 必须 提供 介 于 0 和 255 之 间 的 某 个 值 。 


可 以 使 用 setPixels 方法 提供 批量 的 像素 。 需 要 设置 矩形 的 起 始 像素 的 位 置 和 和 矩形 的 
视 度 和 高 度 。 接 着 ， 提 供 一 个 包含 所 有 像素 的 样本 值 的 一 个 数组 。 例 如 ， 如 果 你 缓冲 的 图 
像 有 一 个 TYPE_INT_AR6GB 类 型 ， 那 么 就 应 该 提供 第 一 个 像素 的 红 、 绿 、 蔓 和 透明 度 的 值 
(alpha)， 然 后 ， 提 供 第 二 个 像素 的 红 、 绿 、 蓝 和 透明 度 的 值 ， 以 此 类 推 ， 


int[] pixels = new int[4 * width * height]; 





ec 


oe The eee ado 一 as i i Git i a te TF 


re. oe Se 一 


ee E ee EEEE VEN E EE NE IE ee Ne eT EE ME as EE EE a EN EEEN S N ET ye qs me ne TE PS gt ees Shae ee eee Sere 


#1lF BRAWT 673 


pixels[0] =. . . // red value for first pixel 

pixels[1] = . . . // green value for first pixel 
pixels(2] =... // blue value for first pixel 
pixels[3] =. . . // alpha value for first pixel 


raster.setPixels(x, y, width, height, pixels); 
反 过 来 ， 如 果 要 读 人 一 个 像素 ， 可 以 使 用 getPixel 方法 。 这 需要 提供 一 个 含有 四 个 整 
数 的 数组 ， 用 以 存放 各 个 样本 值 : 


int[] sample = new int[4] ; 
raster.getPixel(x, y, sample); 
Color c = new Color(sample[0], sample[1], sample[2], sample[3]); 


可 以 使 用 getPixels 方法 来 读 取 多 个 像素 : 
raster.getPixels(x, y, width, height, samples); 


如 果 使 用 的 图 像 类 型 不 是 TYPE_INT_ARGB， 并 且 已 知 该 类 型 是 如 何 表示 像素 值 的 ， 那 
么 仍旧 可 以 使 用 getPixel/setPixel 方法 。 不 过 ， 必 须要 知道 该 特定 图 像 类 型 的 样本 值 是 
如 何 进 行 编码 的 。 

如 果 需 要 对 任意 未 知 类 型 的 图 像 进 行 处 理 ， 那 么 你 就 要 费 神 了 。 每 一 个 图 像 类 型 都 有 一 
个 颜色 模型 ， 它 能 够 在 样本 值 数组 和 标准 的 RGB 颜色 模型 之 间 进 行 转换 。 


注意 : RGB 颜色 模型 并 不 像 你 想象 中 的 那么 标准 。 颜 色 值 的 确切 样子 依赖 于 成 像 设 备 
的 特性 。 数 码 相 机 、 扫 描 仪 、 控 制 器 和 LCD 显示 器 等 都 有 它们 独 有 的 特性 。 结 果 是 ， 
同样 的 RGB 值 在 不 同 的 设备 上 看 上 去 就 存在 很 大 的 差别 。 国 际 配 色 联盟 (http://www. 
color.org) 推荐 ， 所 有 的 颜色 数据 都 应 该 配 有 一 个 ICC 配置 特性 ， 它 用 以 设 定 各 种 颜色 
是 如 何 映 射 到 标准 格式 的 ， 比 如 1931 CIE XYZ 颜色 技术 规范 。 该 规范 是 由 国际 照明 委 
员 会 即 CIE (Commission Internationale de I’Eclairage, # A 4 Æ: http://www.cie.co.at/ 
cie) 制定 的 。 该 委员 会 是 负责 提供 涉及 照明 和 颜色 等 相关 领域 事务 的 技术 指导 的 国际 性 
机 构 。 该 规范 是 显示 肉眼 能 够 察觉 到 的 所 有 颜色 的 一 个 标准 化 方法 。 它 采用 称 为 X、Y、 
Z 三 元 组 坐标 的 方式 来 显示 颜色 。( 关 于 1931 CIE XYZ 规范 的 详尽 信息 ， 可 以 参阅 Foley、 
van Dam 和 Feiner 4 A Pf 4% 5 #9 C Computer Graphics: Principles and Practice 》 一 书 的 第 
13 €.) 

ICC 配置 特性 非常 复杂 。 然 而 ， 我 们 建议 使 用 一 个 相对 简单 的 标准 ， 称 为 SRGB (请 
访问 其 网 址 http://www.w3.org/Graphics/Color/sRGB.html)。 它 设 定 了 RGB 值 与 1931 CIE 
XYZ 值 之 间 的 具体 转换 方法 ， 它 可 以 非常 出 色 地 在 通用 的 彩色 监视 器 上 应 用 。 当 需要 在 
RGB 与 其 他 颜色 空间 之 间 进 行 转换 的 时 候 ，Java 2D API 就 使 用 这 种 转换 方式 。 
getColorModel 方法 返回 一 个 颜色 模型 : 


ColorModel model = image.getColorModel () ; 


为 了 了 解 一 个 像素 的 颜色 值 ， 可 以 调用 Raster 类 的 getDataElements 方法 。 这 个 方 
法 返回 了 一 个 0bject， 它 包含 了 有 关 该 颜色 值 的 与 特定 颜色 模型 相关 的 描述 : 
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Object data = raster.getDataElements(x, y, null); 


国 注意 : getDataElements 方法 返回 的 对 象 实 际 上 是 一 个 样本 值 的 数组 。 在 处 理 这 个 对 象 
时 ， 不 必要 了 解 到 这 些 。 但 是 ， 它 却 解释 了 为 什么 这 个 方法 名 叫做 getDataElements 
的 原因 。 


颜色 模型 能 够 将 该 对 象 转换 成 标准 的 ARGB 的 值 。getRGB 方法 返回 一 个 int 类 型 
的 值 ， 它 把 透明 度 (alpha)、 红 、 绿 和 蓝 的 值 打包 成 四 个 块 ， 每 块 包含 8 位 。 也 可 以 使 用 
Color(int argb, boolean hasAlpha) 构造 器 来 构建 一 个 颜色 的 值 : 


int argb = mode1,getRCB(data) ; 
Color color = new Color(argb, true); 


如 果 要 把 一 个 像素 设置 为 某 个 特定 的 颜色 值 ， 需 要 按 与 上 述 相 反 的 步 又 进行 操作 。Ccolor 
类 的 getRGB 方法 会 产生 一 个 包含 透明 度 、 红 、 绿 和 蓝 值 的 int 型 值 。 把 这 个 值 提 供给 
ColorModel 类 的 getDataElements 方法 ， 其 返回 值 是 一 个 包含 了 该 颜色 值 的 特定 颜色 模型 
描述 的 0bject。 再 将 这 个 对 象 传递 给 WritableRaster 类 的 setDataETements 方法 . 


int argb = color.getRGB(); 
Object data = model.getDataElements(argb, null); 
raster. setDataElements(x, y, data); 


为 了 国明 如 何 使 用 这 些 方法 来 用 各 个 像素 构建 图 
像 ， 我 们 按照 传统 ， 绘 制 了 一 个 Mandelbrot 集 ， 如 
图 11-28 所 示 。 

Mandelbrot 集 的 思想 就 是 把 平面 上 的 每 一 点 和 
一 个 数字 序列 关联 在 一 起 。 如 果 数 字 序 列 是 收敛 的 ， 
该 点 就 被 着 色 。 如 果 数 字 序 列 是 发 散 的 ， 该 点 就 处 于 
透明 状态 。 

下 面 就 是 构建 简单 Manderbrot 集 的 方法 。 对 于 
每 一 个 点 (a, b)， 你 都 能 按照 如 下 的 公式 得 到 一 个 点 
集 序列 ， 其 开始 于 点 (x, y) = (0, 0)， 反 复 进行 迭代 : 


Xnew =X -y +a 


图 11-28 Mandelbrot Æ 


Wm=2"%"y+b 

结果 证 明 ， 如 果 x 或 者 y 的 值 大 于 2， 那 么 序列 就 是 发 散 的 。 仅 有 那些 与 导致 数字 序列 
收敛 的 点 (a,b) 相对 应 的 像素 才 会 被 着 色 。( 该 数字 序列 的 计算 公式 基本 上 是 从 复杂 的 数学 概 
念 中 推导 出 来 的 。 我 们 只 使 用 现成 的 公式 ， 如 果 要 了 人 解 更 多 的 分 形 数学 概念 的 详细 说 明 ， 请 
查看 http://classes.yale.edu/fractals/) 

程序 清单 11-8 显示 了 该 代码 。 在 此 程序 中 ， 我 们 展示 了 如 何 使 用 ColorModel 类 将 
Color 值 转换 成 像素 数据 。 这 个 过 程 和 图 像 的 类 型 是 不 相关 的 。 为 了 增加 些 趣味 ， 你 可 以 把 
缓冲 图 像 的 颜色 类 型 改变 为 TYPE_BYTE_GRAY。 不必 改变 程序 中 的 任何 代码 ， 该 图 像 的 颜色 
模型 会 自动 地 负责 把 颜色 转换 为 样本 值 。 
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package rasterImage; 


import java.awt.*; 
import java.awt. image. *; 
import javax.swing.*; 


内 内 

* This frame shows an image with a Mandelbrot set. 
10 public class RasterImageFrame extends JFrame 
uf 

12 private static final double XMIN = -2; 

1 private static final double XMAX = 2; 

14 private static final double YMIN = -2; 

15 private static final double YMAX = 2; 

16 private static final int MAX_ITERATIONS = 16; 
17 private static final int IMAGE_WIDTH = 400; 
18 private static final int IMAGE_HEIGHT = 400; 


oon Am Se we N pp 


20 public RasterImageFrame() 


{ 
22 BufferedImage image = makeMandelbrot(IMAGE_WIDTH, IMAGE_HEIGHT) ; 


23 add(new JLabel (new ImageIcon(image))) ; 
24 pack() ; 

25 } 

26 

27 /** 


28 * Makes the Mandelbrot image. 
29 * @param width the width 

30 * @arah height the height 

31 * @return the image 


32 */ 

3 public BufferedImage makeMandelbrot(int width, int height) 

34 { 

35 BufferedImage image = new BufferedImage(width, height, BufferedImage. TYPE_INT_ARGB) ; 
36 WritableRaster raster = image.getRaster() ; 

37 ColorModel model = image.getColorModel (); 

38 

39 Color fractalColor = Color. red; 

40 int argb = fractalColor.getRGB() ; 

41 Object colorData = model.getDataElements(argb, null); 

42 

43 for (int i = 0; i < width; i++) 

44 for (int j = 0; j < height; j++) 

45 { 

46 double a = XMIN + i * (XMAX - XMIN) / width; 

47 double b = YMIN + j * (YMAX - YMIN) / height; 

48 if (!escapesToInfinity(a, b)) raster.setDataElements(i, j, colorData) ; 
49 } 

50 return image; 

51 } 


53 private boolean escapesToInfinity(double a, double b) 
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54 { 

55 double x = 0.0; 

56 double y = 0.0; 

57 int iterations = 0; 

58 while (x <= 2 && y <= 2 && iterations < MAX_ITERATIONS) 
59 { 

60 double xnew=x*x-y* yas 
61 double ynew=2*x*y+b; 

62 X = xnew; 

63 y = ynew; 

64 iterations++; 

65 } 

66 return x > 2 || y > 2; 

67 } 

68 } 








e BufferedImage(int width, int height, int imageType) 
构建 一 个 被 缓存 的 图 像 对 象 。 
参数 : width, height 图像 的 尺寸 
imageType 图 像 的 类 型 ， 最 常用 的 类 型 是 TYPE_INT_RGB、TYPE_INT_ 
ARGB, TYPE_BYTE_GRAY 和 TYPE_BYTE_INDEXED 
e ColorModel getColorModel() 
返回 被 缓存 图 像 的 颜色 模型 。 
eWritableRaster getRaster() 


获得 访问 和 修改 该 缓存 图 像 像素 的 光栅 。 













e Object getDataElements(int x, int y, Object data) 
JK IFES CLA EASE, ORE FMB, TT ORCL BE AK F 
颜色 模型 。 如 果 data 不 为 nu11， 那 么 它 将 被 视 为 是 适合 于 存放 样本 数据 的 数组 ， 从 
而 被 充填 。 如 果 data 为 nu11， 那 么 将 分 配 一 个 新 的 数组 ， 其 元 素 的 类 型 和 长 度 依赖 
于 颜色 模型 。 

e intl] getPixel(int x, int y, int[] sampleValues) 

efloat[] getPixel(int x, int y, float[] sampleValues) 

edouble[] getPixel(int x, int y, double[] sampleValues) 

eintL] getPixels(int x, int y, int width, int height, int[] 
sampleValues) 

efloat[] getPixels(int x, int y, int width, int height, float[] 
sampleValues ) 

edouble[] getPixels(int x, int y, int width, int height, double[] 


华章 IT 
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sampleValues ) 
返回 某 个 光栅 点 或 者 是 由 光栅 点 组 成 的 某 个 矩形 的 样本 值 ， 该 数据 位 于 一 个 数组 中 ， 
数组 的 长 度 依赖 于 颜色 模型 。 如 果 sampleValues 不 为 nu11， 那 么 该 数组 被 视 为 长 
度 足 够 存放 样本 值 ， 从 而 该 数组 被 填充 。 如 果 sampleValues 为 nu11， 就 要 分 配 一 
个 新 数组 。 仅 当 你 知道 某 一 颜色 模型 的 样本 值 的 具体 含义 的 时 候 ， 这 些 方法 才 会 有 用 。 





evoid setDataElements(int x, int y, Object data) 
设置 光栅 点 的 样本 数据 。data 是 一 个 已 经 填 人 了 某 一 像素 样本 值 的 数组 。 数 组 元 素 的 
类 型 和 长 度 依 赖 于 颜色 模型 。 

è void setPixel(int x, int y, int[] sampleValues) 

evoid setPixel(int x, int y, float[] sampleValues) 

èe void setPixel(int x, int y, double[] sampleValues) 

evoid setPixels(int x, int y, int width, int height, int[] 
sampleValues ) 

evoid setPixels(int x, int y, int width, int height, float[] 
sampleValues ) 

evoid setPixels(int x, int y, int width, int height, double[] 
sampleValues ) 
设置 某 个 光栅 点 或 由 多 个 光栅 点 组 成 的 矩形 的 样本 值 。 只 有 当 你 知道 颜色 模型 样本 值 

的 编码 规则 时 ， 这 些 方法 才 会 有 用 。 





eint getRGB(Object data) 


返回 对 应 于 data 数组 中 传递 的 样本 数据 的 ARGB 值 。 其 元 素 的 类 型 和 长 度 依赖 于 颜 
色 模 型 。 

e Object getDataElements(int argb, Object data); 
返回 某 个 颜色 值 的 样本 数据 。 如 果 data 不 为 nu11， 那 么 该 数组 被 视 为 非常 适合 于 存 
放样 本 值 ， 进 而 该 数组 被 填充 。 如 果 data 为 nu11， 那 么 将 分 配 一 个 新 的 数组 。data 
是 一 个 填充 了 用 于 某 个 像素 的 样本 数据 的 数组 ， 其 元 素 的 类 型 和 长 度 依赖 于 该 颜色 
模型 。 






eColor(int argb, boolean hasAlpha) 1.2 
如 果 hasAlpha 的 值 是 true， 则 用 指定 的 ARGB 组 合 值 创建 一 种 颜色 。 如 果 hasAlpha 
的 值 是 fal1se， 则 用 指定 的 RGB 值 创 建 一 种 颜色 。 

è int getRGB( ) : 
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返回 和 该 颜色 相对 应 的 ARGB 颜色 值 。 


11.11.2 ”图 像 过 滤 


在 前 面 的 章节 中 ， 我 们 介绍 了 从 头 开始 构建 图 像 的 方法 。 然 而 ， 你 常常 是 因为 另 一 个 原 
因 去 访问 图 像 数据 的 : 你 已 经 拥有 了 一 个 图 像 ， 并 且 想 从 某 些 方面 对 图 像 进 行 改 进 。 

当然 ， 可 以 使 用 前 一 节 中 的 getPixel/getDataElements 方法 来 读 取 和 处 理 图 像 数 
据 ， 然 后 把 图 像 数据 写 回 到 文件 中 。 不 过 ， 幸 运 的 是 ，Java 2D API 已 经 提供 了 许多 过 滤器 ， 
它们 能 够 执行 常用 的 图 像 处 理 操 作 。 

图 像 处 理 都 实现 了 BufferedImage0p 接口 。 构 建 了 图 像 处 理 的 操作 之 后 ， 只 需 调用 
filter 方法 ， 就 可 以 把 该 图 像 转换 成 男 一 个 图 像 。 


BufferedImageOp op =.. .; 
BufferedImage filteredImage = 

new BufferedImage(image.getWidth(), image.getHeight(), image.getType()); 
op.filter(image, filteredImage) ; 


有 些 图 像 操 作 可 以 恰当 地 (通过 op.filter(image, image) J) 转换 一 个 图 像 ， 但 
是 大 多 数 的 图 像 操 作 都 做 不 到 这 一 点 。 
以 下 五 个 类 实现 了 BufferedImage0p 接口 。 


AffineTransformOp 
Rescale0p 
Lookup0p 
ColorConvert0p 
Convolve0p 


AffineTransformOp 类 用 于 对 各 个 像素 执行 仿 射 变 换 。 人 例如， 下面 的 代码 就 说 明了 如 
何 使 一 个 图 像 围绕 着 它 的 中 心 旋 转 。 


AffineTransform transform = AffineTransform.getRotateInstance (Math. toRadians (angle), 
image.getWidth() / 2, image.getHeight() / 2); 

AffineTransform0p op = new AffineTransformOp(transform, interpolation) ; 

op.filter(image, filteredImage) ; 


AffineTransformOp 构造 器 需要 一 个 仿 射 变换 和 一 个 
渐变 变换 策略 。 如 果 源 像素 在 目标 像素 之 间 的 某 处 会 发 生变 









换 的 话 ， 那 么 就 必须 使 用 渐变 变换 策略 来 确定 目标 图 像 的 像 Core Java 
素 。 例如， 如 果 旋 转 源 像素 ， 那 么 通常 它们 不 会 精确 地 落 在 otume I- Advanced Features 


EIGHTH EDITION 





目标 像素 上 。 有 两 种 渐变 变换 策略 : AffineTransformOp. 
TYPE_BILINEAR 和 AffineTransformOp.TYPE_NEAREST_ 
NEIGHBOR。 双 线性 ( Bilinear) 渐变 变换 需要 的 时 间 较 长 ,但 
是 变换 的 效果 却 更 好 。 

使 用 程序 清单 11-9 的 程序 ， 可 以 把 一 个 图 像 旋转 5” ( 参 
见 图 11-29 ) 。 

RescaleOp 用 于 为 图 像 中 的 所 有 的 颜色 构件 执行 一 个 调 。 图 11-29 一 个 旋转 的 图 像 
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整 其 大 小 的 变换 操作 〈 透 明度 构件 不 受 影 啊 ) 
和 二 二 
用 a>1 进行 调整 ， 那 么 调整 后 的 效果 是 使 图 像 变 亮 。 可 以 通过 设 定 调整 大 小 的 参数 和 可 
选 的 绘图 提示 来 构建 Rescale0p。 在 程序 清单 11-9 中 ， 我 们 使 用 下 面 的 设置 : 


float a = 1.1f; 
float b = 20.0f; 
RescaleOp op = new RescaleQp(a, b, null); 


也 可 以 为 每 个 颜色 构件 提供 单独 的 缩放 值 ， 参 见 API 说 明 。 

使 用 Lookupop 操作 ， 可 以 为 样本 值 设 定 任意 的 映射 操作 。 你 提供 一 张 表格 ， 用 于 设 定 
每 一 个 样本 值 应 该 如 何 进行 映射 操作 。 在 示例 程序 中 ， 我 们 计算 了 所 有 颜色 的 反 ， 即 将 颜色 
c ABR 255 一 C, 

LookupOp 构造 器 需要 一 个 类 型 是 LookupTable 的 对 象 和 一 个 选项 提示 映射 表 。 
LookupTable 是 抽象 类 ， 其 有 两 个 实体 子 类 : ByteLookupTable 和 ShortLookupTable。 
因为 RGB 颜色 值 是 由 字 节 组 成 的 ， 所 以 ByteLookupTable 类 应 该 就 够 用 了 。 但 是 ， 考 虑 
到 在 http://bugs.sun.com/bugdatabase/view_bug.do?bug_id=6183251 中 描述 的 缺陷 ， 我 们 将 使 用 
ShortLookupTab1le。 下 面 的 代码 说 明了 我 们 在 程序 清单 中 是 如 何 构建 一 个 Lookup0Op 类 的 : 


short negative[] = new short[256]; 

for (int i = 0; 1 < 256; i++) negative[i] = (short) (255 - i); 
ShortLookupTable table = new ShortLookupTable(0, negative) ; 
LookupOp op = new LookupOp(table, null); 


此 项 操作 可 以 分 别 应 用 于 每 个 颜色 构件 ， 但 是 不 能 应 用 于 透明 度 值 。 也 可 以 为 每 个 颜色 
构件 提供 单独 的 查找 表 ， 参 见 API 说 明 。 


注意 : 不 能 将 LookupOp 用 于 带 有 索引 颜色 模型 的 图 像 。( 在 这 些 图 像 中 ， 每 个 样本 值 都 
是 调 色 板 中 的 一 个 偏 移 量 。) 


ColorConvertOp 对 于 颜色 空间 的 转换 非常 有 用 。 我 们 不 准备 在 这 里 讨论 这 个 问题 了 。 

ConvolveOp 是 功能 最 强大 的 转换 操作 ， 它 用 于 执行 卷 积 变换 。 我 们 不 想 过 分 深入 地 介 
绍 卷 积 变换 的 详尽 细节 。 不 过 ， 其 基本 概念 还 是 比较 简单 的 。 我 们 不 妨 看 一 下 模糊 过 滤器 的 
例子 ( 见 图 11-30 )。 

这 种 模糊 的 效果 是 通过 用 像素 和 该 像素 临近 的 8 个 像素 的 平均 值 来 取代 每 一 个 像素 值 而 
达到 的 。 和 凭借 直观 感觉 ， 就 可 以 知道 为 什么 这 种 变换 操作 能 使 得 图 像 变 模糊 了 。 从 数学 理论 
上 来 说 ， 这 种 平均 法 可 以 表示 为 一 个 以 下 面 这 个 矩阵 为 内 核 的 卷 积 变换 操作 
1/9 1/9 1/9 
1/9 1/9 1/9 
1/9 1/9 1/9 

卷 积 变换 操作 的 内 核 是 一 个 矩阵 ， 用 以 说 明 在 临近 的 像素 点 上 应 用 的 加 权 值 。 应 用 上 面 
的 内 核 进行 卷 积 变换 ， 就 会 产生 一 个 模糊 图 像 。 下 面 这 个 不 同 的 内 核 用 以 进行 图 像 的 边缘 检 
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测 ， 碍 找 图 像 颜色 变化 的 区 域 : 
0 -1 0 
-1 4-1 
0 -1 0 
边缘 检测 是 在 分 析 摄 影 图 片 时 使 用 的 一 项 非常 重要 的 技术 (参见 图 11-31 )。 


Core java 


Voume il Advanced Features 


i. 





图 11-30 ”对 图 像 进行 模糊 处 理 图 11-31 边缘 检测 


如 果 要 构建 一 个 卷 积 变换 操作 ， 首 先 应 为 矩阵 内 核 建立 一 个 含有 内 核 值 的 数组 ， 并 且 构 
建 一 个 Kerne1 对 象 。 接 着 ， 根 据 内 核对 象 建立 一 个 Convo1ve0p 对 象 ， 进 而 执行 过 滤 操 作 。 


float[] elements = 


0.0f, -1.0f, 0.0f, 
-1.0f, 4.f, -1.0f, 
0.0f, -1.0f, 0.0f 





Kernel kernel = new Kernel(3, 3, elements); 
Convolve0p op = new ConvolveOp(kernel) ; 
op.filter(image, filteredImage) ; 


使 用 程序 清单 11-9 的 程序 ， 用 户 可 以 装载 一 个 GIF 或 者 JPEG 图 像 ， 并 且 执 行 我 们 已 经 
介绍 过 的 各 种 图 像 处 理 的 操作 。 由 于 Java 2D API 的 图 像 处 理 的 功能 很 强大 ， 下 面 的 程序 非 
常 简单 。 


package imageProcessing; 


import java.awt.*; 
import java.awt.geom.*; 
import java.awt. image. *; 
import java.io.*; 


import javax.imageio.*; 
import javax.swing.*; 


bo oo N oe N ee 
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10 import javax.swing. filechooser.*; 

11 

12 /** 

9 * This frame has a menu to load an image and to specify various transformations, and a component 
14 * to show the resulting image. 

i H 

16 public class ImageProcessingFrame extends JFrame 

7 { 

18 private static final int DEFAULT_WIDTH = 400; 

19 private static final int DEFAULT_HEIGHT = 400; 


21 private BufferedImage image; 


23 public ImageProcessingFrame() 


24 { 

25 setTitle("ImageProcessinglest") ; 

26 setSize(DEFAULT WIDTH, DEFAULT_HEIGHT) ; 

27 

28 add(new JComponent () 

29 

30 public void paintComponent (Graphics g) 

31 { 

32 if (image != null) g.drawImage(image, 0, 0, null); 
3 } 

34 }); 

35 

36 JMenu fileMenu = new JMenu("File"); 

37 JMenuItem openItem = new JMenuItem("0pen") ; 

38 openItem.addActionListener(event -> openFile()); 
39 fi leMenu.add(openItem) ; 

40 

41 JMenuItem exitItem = new JMenuItem("Exit"); 

42 exitItem.addActionListener(event -> System.exit(0)); 
43 fi leMenu.add(exitItem) ; 

44 

45 JMenu editMenu = new JMenu("Edit"); 

46 JMenuItem blurItem = new JMenuItem("Blur"); 

47 blurItem.addActionListener(event -> 

48 { 

49 float weight = 1.0f / 9.0f; 

50 float[] elements = new float[9] ; 

51 for (int i = 0; 1 < 9; i++) 

52 elements[i] = weight; 

53 convolve (elements) ; 

54 H; 

55 editMenu.add(blurItem) ; 

56 

57 JMenuItem sharpenItem = new JMenuItem("Sharpen") ; 
58 sharpenItem.addActionListener(event -> 

59 { 

60 float[] elements = { 0.0f, -1.0f, 0.0f, -1.0f, 5.f, -1.0f, 0.0f, -1.0f, 0.0f }; 
61 convolve(elements) ; 

62 ; 

63 edi tMenu.add(sharpenItem) ; 
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65 JMenuItem brightenItem = new JMenuItem("Brighten"); 

66 brightenItem.addActionListener(event -> 

67 { 

68 float a = 1.1f; 

69 float b = 20.0f; 

70 RescaleOp op = new RescaleOp(a, b, null); 

71 filter(op); 

n ); 

73 editMenu.add(brightenItem) ; 

74 

75 JMenuItem edgeDetectItem = new JMenuItem("Edge detect"); 
76 edgeDetectItem.addActionListener(event -> 

77 { 

78 float[] elements = { 0.0f, -1.0f, 0.0f, -1.0f, 4.f, -1.0f, 0.0f, -1.0f, 0.0f }; 
79 convolve (elements) ; 

80 i): 

81 editMenu.add(edgeDetectItem) ; 

82 

83 JMenuItem negativeltem = new JMenultem("Negative") ; 

84 negativeltem.addActionListener(event -> 

85 { 

86 short[] negative = new short[256 * 1]; 

87 for (int i = 0; i < 256; i++) 

88 negative(i] = (short) (255 - i); 

89 ShortLookupTable table = new ShortLookupTable(0, negative); 
90 Lookup0p op = new LookupOp(table, null); 

91 filter(op); 

92 D; 

93 edi tMenu.add(negativeItem) ; 

94 

95 JMenuItem rotateItem = new JMenuItem("Rotate"); 

96 rotateItem.addActionListener(event -> 

97 

98 if (image == null) return; 

99 AffineTransform transform = AffineTransform.getRotateInstance(Math.toRadians(5), 
100 image.getWidth() / 2, image.getHeight() / 2); 
101 AffineTransformOp op = new AffineTransform0p(transform, 
102 AffineTransformOp.TYPE_BICUBIC) ; 

103 filter(op); 

104 ae 

105 editMenu.add(rotateItem) ; 

106 

107 JMenuBar menuBar = new JMenuBar(); 

108 menuBar.add(fileMenu) ; 

109 menuBar. add (edi tMenu) ; 

110 Set JMenuBar (menuBar) ; 

11} 

112 

n3  /** 

114 * Open a file and load the image. 

115 */ 


116 public void openFile() 
u7 1{ 
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118 JFileChooser chooser = new JFileChooser("."); 

119 chooser.setCurrentDirectory(new File(getClass() .getPackage() . getName ())) ; 

120 String[] extensions = ImageI0.getReaderFileSuffixes () ; 

121 chooser. setFileFilter(new FileNameExtensionFilter("Image files", extensions)); 
122 int r = chooser. showOpenDialog(this) ; 


123 if (r != JFileChooser.APPROVE_OPTION) return; 


125 try 

126 { 

127 Image img = ImageI0.read(chooser.getSelectedFile()) ; 
128 image = new BufferedImage(img.getWidth(null), img.getHeight(nul1), 
129 BufferedImage. TYPE_INT_RGB) ; 

130 image. getGraphics() .drawImage(img, 0, 0, null); 

131 } 

132 catch (IOException e) 

133 

134 JOptionPane. showMessageDialog(this, e); 

135 

136 repaint(); 

137 

138 

39 jt 


140 * Apply a filter and repaint. 
141 * @param op the image operation to apply 


142 */ 

143 private void filter(BufferedImage0p op) 
mo { 

145 if (image == null) return; 

146 image = op.filter(image, null); 

147 repaint(); 

148 

149 

go /** 


151 * Apply a convolution and repaint. 

152 * @param elements the convolution kernel (an array of 9 matrix elements) 
153 */ 

154 private void convolve(float[] elements) 


156 Kernel kernel = new Kernel(3, 3, elements); 
157 ConvolveOp op = new ConvolveOp(kernel) ; 

158 filter(op) ; 

s90 } 

160 } 





e BufferedImage filter(BufferedImage source, BufferedImage dest) 
将 图 像 操 作 应 用 于 源 图 像 ， 并 且 将 操作 的 结果 存放 在 目标 图 像 中 。 如 果 dest 为 
nu11， 一 个 新 的 目标 图 像 将 被 创建 。 该 目标 图 像 将 被 返回 。 








e AffineTransformOp(AffineTransform t, int interpolationType) 
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构建 一 个 仿 射 变 换 操 作 符 。 渐 变 变 换 的 类 型 是 TYPE_BILINEAR、TYPE_BICUBIC 或 者 
TYPE_NEAREST_NEIGHBOR 中 的 一 个 。 











float b, RenderingHints hints) 
® RescaleOp(float[] as, float[] bs, RenderingHints hints) 

构建 一 个 进行 尺寸 调整 的 操作 符 ， 它 会 执行 缩放 操作 x,。, = ax + b。 当 使 用 第 一 个 构 
造 硬 时 ， 所 有 的 颜色 构件 (但 不 包括 透明 度 构 件 ) 都 将 按照 相同 的 系数 进行 缩放 。 当 使 
用 第 二 个 构造 器 时 ， 可 以 为 每 个 颜色 构件 提供 单独 的 值 ， 在 这 种 情况 下 ， 透 明度 构件 
不 受 影 响 ， 或 者 为 每 个 颜色 构件 和 透明 度 构件 都 提供 单独 的 值 。 


e RescaleOp(float a, 





e LookupOp(LookupTable table, RenderingHints hints) 
为 给 定 的 查找 表 构 建 一 个 查找 操作 符 。 





e ByteLookupTable(int offset, byte[] data) 
e ByteLookupTable(int offset, byte[][] data) 

为 转化 byte 值 构建 一 个 字 节 查找 表 。 在 查找 之 前 ， 从 输入 中 减 去 偏 移 量 。 在 第 一 个 构 
抬 名 中 的 值 将 提供 给 所 有 的 颜色 构件 ， 但 不 包括 透明 度 构件 。 当 使 用 第 二 个 构造 器 时 ， 
可 以 为 每 个 颜色 构件 提供 单独 的 值 ， 在 这 种 情况 下 ， 透 明度 构件 不 受 影响 ， 或 者 为 每 
个 颜色 构件 和 透明 度 构件 都 提供 单独 的 值 。 





e ShortLookupTable(int offset, short[] data) 

e ShortLookupTable(int offset, short[][] data) 

为 转化 short 值 构建 一 个 字 节 查找 表 。 在 查找 之 前 ， 从 输入 中 减 去 偏 移 量 。 在 第 一 个 构 
氨 帮 中 的 值 将 提供 给 所 有 的 颜色 构件 ， 但 不 包括 透明 度 构件 。 当 使 用 第 二 个 构造 器 时 ， 
可 以 为 每 个 颜色 构件 提供 单独 的 值 ， 在 这 种 情况 下 ， 透 明度 构件 不 受 影响 ， 或 者 为 每 
个 颜色 构件 和 透明 度 构 件 都 提供 单独 的 值 。 





e ConvolveOp(Kernel kernel) 


e ConvolveOp(Kernel kernel, int edgeCondition, RenderingHints hints) 
构建 一 个 卷 积 变换 操作 符 。 边 界 条 件 是 EDGE_NO_OP #f] EDGE_ZERO_FILL 两 种 方式 之 
一 。 由 于 边界 值 没 有 足够 的 临近 值 来 进行 卷 积 变换 的 计算 ， 所 以 边界 值 必须 被 特殊 处 
理 ， 其 默认 值 是 EDGE_ZERO_FILL， 
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eKernel(int width, int height, float[] matrixElements) 
为 指定 的 矩阵 构建 一 个 内 核 。 


11.12 ”打印 


最 初 的 IDK 根本 不 支持 打印 操作 。 它 不 可 能 从 applets 中 进行 打印 操作 ， 如 果 想 在 应 用 
中 使 用 打印 操作 ， 必 须 获 得 第 三 方 的 类 库 。JDK1.1 提供 了 非常 轻 量 级 的 打印 支持 ， 仅 仅 能 够 
产生 简单 的 打印 输出 ， 不 过 只 要 你 对 打印 的 质量 没有 太 高 的 要 求 也 就 够 用 了 。JDK 1.1 的 打 
印 模型 被 设计 为 允许 浏览 器 供应 商 打 印 出 现在 网 页 中 的 applet 外 观 ( 然 而， 浏览 絮 供 应 商 对 

此 并 不 感 兴趣 )。 

Java SE 1.2 开始 推出 了 一 种 强大 的 打印 模型 ， 它 和 Java 2D 图 形 实 现 了 完全 的 集成 。 
JDK1.4 增加 了 许多 重要 的 增强 特性 ， 比 如 ， 查 找 打 印 机 的 特性 和 用 于 服务 器 端 打 印 管理 的 流 
式 打印 作业 等 。 

在 本 节 中 ， 我 们 将 介绍 如 何在 单 页 纸 上 轻 松 地 打印 出 一 幅 图 画 ， 如 何 来 管理 多 页 打印 输 
出 ， 还 有 如 何 利 用 Java 2D 图 像 模 型 的 出 色 特 性 ， 以 及 如 何方 便 地 产生 一 个 打印 预览 对 话 框 。 


11.12.1 图 形 打 印 


在 本 节 中 ， 我 们 将 处 理 最 常用 的 打印 情景 ， 即 打印 一 个 2D 图 形 ， 当 然 该 图 形 可 以 含有 
不 同 字体 组 成 的 文本 ， 甚 至 可 能 完全 由 文本 构成 。 

如 果 要 生成 打印 输出 ， 必 须 完 成 下 面 这 两 个 任务 : 

o 提供 一 个 实现 了 Printable 接口 的 对 象 。 

e 启动 一 个 打印 作业 。 

Printable 接口 只 有 下 面 一 个 方法 : 

int print(Graphics g, PageFormat format, int page) 

每 当 打 印 引擎 需 要 对 某 一 页 面 进行 排版 以 便 打印 时 ， 都 要 调用 这 个 方法 。 你 的 代码 绘制 
了 准备 在 图 形 上 下 文 上 打印 的 文本 和 图 像 ， 页 面 排版 显示 了 纸张 的 大 小 和 页 边 距 ， 页 号 显示 
了 将 要 打印 的 页 。 

如 果 要 启动 一 个 打印 作业 ， 需 要 使 用 PrinterUuob 类 。 首 先 ， 应 该 调用 静态 方法 get- 
PrinterJob 来 获取 一 个 打印 作业 对 象 。 然 后 ， 设 置 要 打印 的 Printable 对 象 。 


Printable canvas = 
PrinterJob job = Printerdob. getPrinterJob(); 
job. setPrintable(canvas) ; 


Q 警告 PrintJob 这 个 类 处 理 的 是 JDK1.1 风格 的 打印 操作 ， 这 个 类 已 经 被 弃 用 了 。 请 不 
要 把 PrinterJob 类 同 其 混淆 在 一 起 。 
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在 开始 打印 作业 之 前 ， 应 该 调用 printDialog 方法 来 显示 一 个 打印 对 话 框 ( 见 图 11-32). 
这 个 对 话 框 为 用 户 提供 了 机 会 去 选择 要 使 用 的 打印 机 (在 有 多 个 打印 机 可 用 的 情况 下 )， 选 择 
将 要 打印 的 页 的 范围 ， 以 及 选择 打印 机 的 各 种 设置 。 


ie 





一 个 跨 平台 的 打印 对 话 框 


图 11-32 





可 以 在 一 个 实现 了 PrintRequestAttributeSet 接口 的 类 的 对 象 中 收集 到 各 种 打印 机 
的 设置 ， 例 如 HashPrintRequestAttributeSet 类 . 

HashPrintRequestAttributeSet attributes = new HashPrintRequestAttributeSet() ; 

你 可 以 添加 属性 设置 ， 并 且 把 attributes 对 象 传递 给 printDialog 方法 。 

如 果 用 户 点 击 OK, ABA printDialog 方法 将 返回 true; 如 果 用 户 关 掉 对 话 框 ， 那 么 
该 方法 将 返回 false。 如 果 用 户 接 受 了 设置 ， 那 么 就 可 以 调用 PrinterJob 类 的 print FF 
法 来 局 动 打印 进程 。print 方法 可 能 会 抛 出 一 个 PrinterException 异常 。 下 面 是 打印 代 
码 的 基本 框架 : 

(job.printDialog(attributes)) 


try 


{ 
job. print (attributes) ; 


catch (PrinterException exception) 


{ 


a 
} 

注意 : 在 JDK1.4 之前， 打印 系统 使 用 的 都 是 宿主 平台 本 地 的 打印 和 页 面 设置 对 话 框 。 要 
展示 本 地 打印 对 话 框 ， 可 以 调用 没有 任何 参数 的 printDialog 方法 。( 不 存在 任何 方式 
可 以 用 来 将 用 户 的 设置 收集 到 一 个 属性 集中 。) 
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在 执行 打印 操作 时 ，PrinteryJob 类 的 print 方法 不 断 地 调用 和 此 项 打印 作业 相关 的 
Printable 对 象 的 print 方法 。 

由 于 打印 作业 不 知道 用 户 想 要 打印 的 页 数 ， 所 以 它 只 是 不 断 地 调用 print 方法 。 只 要 
该 print 方法 的 返回 值 是 Printable .PAGE_EXISTS， 打 印 作 业 就 不 断 地 产生 输出 页 。 当 
print 方法 返回 Pringtable.NO_SUCH_PAGE 时 ， 打 印 作 业 就 停止 。 


O 警告 : 打印 作业 传递 到 print 方法 的 打印 页 号 是 从 0 开始 的 。 


因此 ， 在 打印 操作 完成 之 前 ， 打 印 作 业 并 不 知道 准确 的 打印 页 数 。 为 此 ， 打 印 对 话 框 无 
法 显示 正确 的 页 码 范 围 ， 而 只 能 显示 “ Pages 1 to 1”( 从 第 一 页 到 第 一 页 )。 在 下 一 节 中 ,我 
们 将 介绍 如 何 通过 为 打印 作业 提供 一 个 Book 对 象 来 避免 这 个 缺陷 。 

在 打印 的 过 程 中 ， 打 印 作业 反复 地 调用 Printable 对 象 的 print 方法 。 打 印 作 业 可 以 
对 同一 页 面 多 次 调用 print 方法 ， 因 此 不 应 该 在 print 方法 内 对 页 进行 计数 ， 而 是 应 始终 
依赖 于 页 码 参 数 来 进行 计数 操作 。 打 印 作 业 之 所 以 能 够 对 某 一 页 反复 地 调用 print 方法 是 有 
一 定 道理 的 : 一 些 打 印 机 ， 尤 其 是 点 阵 式 打印 机 和 喷 墨 式 打 印 机 ， 都 使 用 条 带 打印 技术 ， 尼 
们 在 打印 纸 上 一 条 接着 一 条 地 打印 。 即 使 是 每 次 打印 一 整 页 的 激光 打印 机 ， 打 印 作 业 都 有 可 
能 使 用 条 带 打印 技术 。 这 为 打印 作业 提供 了 一 种 对 假 脱 机 文件 的 大 小 进行 管理 的 方法 。 

如 果 打 印 作业 需要 printable 对 象 打印 一 个 条 带 ， 那 么 它 可 以 将 图 形 上 下 文 的 筋 切 区 
域 设置 为 所 需要 的 条 带 ， 并 且 调 用 print 方法 。 它 的 绘图 操作 将 按照 条 带 和 矩形 区 域 进行 剪 
切 ， 同 时 ， 只 有 在 条 带 中 显示 的 那些 图 形 元 素 才 会 被 绘制 出 来 。 你 的 print 方法 不 必 晓 得 该 
过 程 ， 但 是 请 注意 : 它 不 应 该 对 剪 切 区 域 产 生 任何 干扰 。 


Q 警告 你 的 print 方法 获得 的 Graphics 对 象 也 是 按照 页 边 距 进行 剪 切 的 。 如 果 和 替换 了 
前 切 区 域 ， 那 么 就 可 以 在 边 距 外 面 进 行 绘图 操作 。 尤 其 是 在 打印 机 的 绘图 上 下 文中 ， 剪 
切 区 域 是 被 严格 遵守 的 。 如 果 想 进一步 地 限制 剪 切 区 域 ， 可 以 调用 c1ip 方法 ， 而 不 是 
setClip 方法 。 如 果 必 须要 移 除 一 个 前 切 区 域 ， 那 么 请 务必 在 你 的 print 方法 开始 处 调 
用 getC1ip 方法， 并 还 原 该 剪 切 区 域 。 


print 方法 的 PageFormat 参数 包含 有 关 被 打印 页 的 信息 。getWidth 方法 和 getHei ght 
方法 返回 该 纸张 的 大 小 ， 它 以 磅 为 计量 单位 。1 磅 等 于 1/72 英 时 。 例 如 ，A4 纸 的 大 小 大 约 
是 595 x 842 磅 ， 美 国人 使 用 的 信纸 大 小 为 612 x 792 磅 。 

磅 是 美国 印刷 业 中 通用 的 计量 单位 ， 让 世界 上 其 他 地 方 的 人 感到 苦恼 的 是 ， 打 印 软件 包 
使 用 的 是 磅 这 种 计量 单位 。 使 用 磅 有 两 个 原因 ， 即 纸张 的 大 小 和 纸张 的 页 边 距 都 是 用 磅 来 计 
量 的 。 对 所 有 的 图 形 上 下 文 来 说 ， 默 认 的 计量 单位 就 是 1 磅 。 你 可 以 在 本 节 后 面 的 示例 程序 
中 证 明 这 一 点 。 该 程序 打印 了 两 行文 本 ， 这 两 行文 本 之 间 的 距离 为 72 磅 。 运 行 一 下 示例 程 
序 ， 并 且 测 量 一 下 基准 线 之 间 的 距离 。 它 们 之 间 的 距离 恰好 是 1 英 时 或 是 25.4 SAK. 

PageFormat 类 的 getWidth 和 getHeight 方法 给 你 的 信息 是 完整 的 页 面 大 小 ， 但 并 不 


© 1 英 时 =0.0254 米 。 一 -一 编辑 注 
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是 所 有 的 纸张 区 域 都 会 被 用 来 打印 。 通 常 的 情况 是 ， 用 户 会 选择 页 边 距 ， 即 使 他 们 没有 选择 
页 边 距 ， 打 印 机 也 需要 用 某 种 方法 来 夹 住 纸张 ， 因 此 在 纸张 的 周围 就 出 现 了 一 个 不 能 打印 的 
区 域 。 

getImageableWidth 和 getImageableHeight 方法 可 以 告诉 你 能 够 真正 用 来 打印 的 
区 域 的 大 小 。 然 而 ， 页 边 距 没有 必要 是 对 称 的 ， 所 以 还 必须 知道 可 打印 区 域 的 左上 角 ， 见 
图 11-33， 它 们 可 以 通过 调用 getImageableX 和 getImageableY 方法 来 获得 。 


& 提示 : 在 print 方法 中 接收 到 的 图 形 上 下 文 是 经 过 剪 切 后 的 图 形 上 下 文 ， 它 不 包括 页 边 
JB, 但是， 坐标 系统 的 原点 仍然 是 纸张 的 左上 角 。 应 该 将 该 坐标 系统 转换 成 可 打印 区 域 
的 左上 角 ， 并 以 其 为 起 点 。 这 只 需 让 print 方法 以 下 面 的 代码 开始 即 可 : 
g.translate(pageFormat.getImageableX(), pageFormat.getImageableY()); 


如 果 想 让 用 户 来 设 定 页 边 距 ， 或 者 让 用 户 在 纵向 和 横向 打印 方式 之 间 切 换 ， 同 时 并 不 涉 
及 设置 其 他 打印 属性 ， 那 么 就 应 该 调用 PrinterJob 类 的 pageDialog 方法 。 


PageFormat format = job.pageDialog(attributes) ; 


注意 : 打印 对 话 框 中 有 一 个 选项 卡 包含 了 页 面 设置 对 话 框 (参见 图 11-34 ) 。 在 打印 前 ， 
你 仍然 可 以 为 用 户 提 供 选 项 来 设置 页 面 格式 。 特 别 是 ， 如 果 你 的 程序 给 出 了 一 个 待 打印 
页 面 的 “所 见 即 所 得 ”的 显示 屏幕 ， 那 么 就 更 应 该 提供 这 样 的 选项 。pageDialog 方法 
返回 了 一 个 含有 用 户 设置 的 PageFormat 对 象 。 





图 11-33 页面 格式 计量 图 11-34 一 个 跨 平台 的 页 面 设置 对 话 框 


程序 清单 11-10 和 程序 清单 11-11 显示 了 如 何在 屏幕 和 打印 页 面 上 绘制 相同 的 一 组 形状 
的 方法 。Jpanel 类 的 一 个 子 类 实现 了 Printable 接口 ， 该 类 中 的 paintComponent 和 
print 方法 都 调用 了 相同 的 方法 来 执行 实际 的 绘图 操作 。 
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class PrintPanel extends JPanel implements Printable 


public void paintComponent (Graphics g) 


{ 
super. paintComponent (g) ; 
Graphics2D g2 = (Graphics2D) g; 
drawPage(g2) ; 

} 


public int print(Graphics g, PageFormat pf, int page) 
throws PrinterException 
{ 


if (page >= 1) return Printable.NO_SUCH_PAGE; 
Graphics2D g2 = (Graphics2D) g; 
g2.translate(pf.getImageableX(), pf.getImageableY()); 
drawPage(g2) ; 
return Printable. PAGE_EXISTS; 

} 


public void drawPage(Graphics2D g2) 


// shared drawing code goes here 


} 

该 示例 代码 显示 并 且 打 印 了 图 11-20， 即 被 用 作 线 条 模式 的 剪 切 区 域 的 消息 “Hello， 
World” 的 边框 。 

可 以 点 击 Print 按钮 来 启动 打印 ,或 者 点 击 页 面 设置 按钮 来 打开 页 面 设置 对 话 框 。 程 序 
清单 11-10 显示 了 它 的 代码 。 


注意 : 为 了 显示 本 地 页 面 设置 对 话 框 ， 需要 将 默认 的 PageFormat 对 象 传 递 给 
pageDialog 方法 。 该 方法 会 克隆 这 个 对 象 ， 并 根据 用 户 在 对 话 框 中 的 选择 来 修改 它 ， 
然后 返回 这 个 克隆 的 对 象 。 


PageFormat defaultFormat = printJob.defaul tPage() ; 
PageFormat selectedFormat = printJob.pageDialog(defaul tFormat) ; 





package print; 


import java.awt.*; 
import java.awt.print.*; 


import javax.print.attribute. *; 
import javax.swing.*; 


oo oOo ē Nu Aa wo > Ww N He 


/** 
10 * This frame shows a panel with 2D graphics and buttons to print the graphics and to set up the 
11 * page format. 
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ji 
public class PrintTestFrame extends JFrame 


{ 
private PrintComponent canvas; 
private PrintRequestAttributeSet attributes; 


public PrintTestFrame() 


Canvas = new PrintComponent() ; 
add(canvas, BorderLayout.CENTER) ; 


attributes = new HashPrintRequestAttributeSet() ; 


JPanel buttonPanel = new JPanel () 
JButton printButton = new JButton("Print"); 
buttonPanel .add(printButton) ; 
printButton.addActionListener(event -> 
{ 
try 
{ 
PrinterJob job = PrinterJob.getPrinterJob(); 
job. setPrintable(canvas) ; 
if (job.printDialog(attributes)) job.print(attributes) ; 


catch (PrinterException ex) 


JOptionPane.showMessageDialog(PrintTestFrame.this, ex); 
} 
}); 


JButton pageSetupButton = new JButton("Page setup"); 
buttonPanel .add(pageSetupButton) ; 
pageSetupButton.addActionListener(event -> 


PrinterJob job = PrinterJob.getPrinterJob(); 
job.pageDialog(attributes) ; 
}); 


add(buttonPanel, BorderLayout.NORTH) ; 
pack() ; 





package print; 


import java.awt.*; 
import java.awt. font.*; 
import java.awt.geom.*; 
import java.awt.print.*; 
import javax. swing. *; 
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g /** 
10 * This component generates a 2D graphics image for screen display and printing. 
u Y 
12 public class PrintComponent extends JComponent implements Printable 
3 { 
14 private static final Dimension PREFERRED SIZE = new Dimension(300, 300); 
15 public void paintComponent (Graphics g) 
16 { 
17 Graphics2D g2 = (Graphics2D) g; 
18 drawPage(g2) ; 
} 


2 public int print(Graphics g, PageFormat pf, int page) throws PrinterException 


22 { 


23 if (page >= 1) return Printable.NO_SUCH_PAGE; 

24 Graphics2D g2 = (Graphics2D) g; 

25 g2.translate(pf.getImageableX(), pf.getImageableY()) ; 

26 g2.draw(new Rectangle2D.Double(0, 0, pf.getImageableWidth() , pf.getImageabl eHeight())); 
27 

28 drawPage(g2) ; 

29 return Printable. PAGE_EXISTS; 

30 } 

31 

32 k% 

33 * This method draws the page both on the screen and the printer graphics context. 
34 * @param g2 the graphics context 

35 */ 

3 public void drawPage(Graphics2D g2) 

37 { 

38 FontRenderContext context = g2.getFontRenderContext () ; 

39 Font f = new Font("Serif", Font.PLAIN, 72); 

40 GeneralPath clipShape = new General Path() ; 

41 

42 TextLayout layout = new TextLayout("Hello", f, context) ; 

43 AffineTransform transform = AffineTransform.getTranslateInstance(0, 72); 
44 Shape outline = layout.getQutline(transform) ; 

45 clipShape.append(outline, false); 

46 

47 layout = new TextLayout("World", f, context); 

48 transform = AffineTransform.getTranslateInstance(0, 144); 

49 outline = layout.getOutline(transform) ; 

50 clipShape.append(outline, false); 

51 

52 g2.draw(clipShape) ; 

53 g2.clip(clipShape) ; 

54 

55 final int NLINES = 50; 

56 Point2D p = new Point2D.Double(0, 0); 

57 for (int i = 0; i < NLINES; i++) 

58 { 

59 double x = (2 * getWidth() * i) / NLINES; 

60 double y = (2 * getHeight() * (NLINES - 1 - i)) / NLINES; 
61 Point2D q = new Point2D.Double(x, y); 


62 g2.draw(new Line2D.Double(p, q)); 
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66 public Dimension getPreferredSize() { return PREFERRED SIZE; } 





® int print(Graphics g, PageFormat format, int pageNumber ) 


绘制 一 个 页 面 ， 并 且 返 回 PAGE_EXISTS， 或 者 返回 NO_SUCH_PAGE, 


参数 : g 在 上 面 绘制 页 面 的 图 形 上 下 文 
format 要 绘制 的 页 面 的 格式 


pageNumber 所 请 求 页 面 的 页 码 





e static PrinterJob getPrinterJob() 
返回 一 个 打印 机 作业 对 象 。 

e PageFormat defaultPage() 
为 该 打印 机 返回 默认 的 页 面 格式 。 

e boolean printDialog(PrintRequestAttributeSet attributes ) 

e boolean printDialog() 
打开 打印 对 话 框 ， 允 许 用 户 选择 将 要 打印 的 页 面 ， 并 且 改 变 打 印 设置 。 第 一 个 方法 将 
显示 一 个 路 平台 的 打印 对 话 框 ， 第 二 个 方法 将 显示 一 个 本 地 的 打印 对 话 框 。 第 一 个 方 
法 修改 了 attributes 对 象 来 反映 用 户 的 设置 。 如 果 用 户 接受 默认 的 设置 ， 两 种 方法 
都 返回 true。 

e PageFormat pageDialog(PrintRequestAttributeSet attributes) 

e PageFormat pageDialog(PageFormat defaults) 
显示 页 面 设 置 对 话 框 。 第 一 个 方法 将 显示 一 个 跨 平 台 的 对 话 框 ， 第 二 个 方法 将 显示 一 
个 本 地 的 页 面 设置 对 话 框 。 两 种 方法 都 返回 了 一 个 PageFormat 对 象 ， 对 象 的 格式 是 
用 户 在 对 话 框 中 所 请 求 的 格式 。 第 一 个 方法 修改 了 attributes 对 象 以 反映 用 户 的 设 
置 。 第 二 个 对 象 不 修改 defaults 对 象 。 

e void setPrintable(Printable p) 

evoid setPrintable(Printable p, PageFormat format) 
设置 该 打印 作业 的 Printable 和 可 选 的 页 面 格式 。 

e void print() 

e void print(PrintRequestAttributeSet attributes) 

反复 地 调用 print 方法 ， 以 打印 当前 的 Printable， 并 将 绘制 的 页 面 发 送 给 打印 机 ， 

直到 没有 更 多 的 页 面 需 要 打印 为 止 。 
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e double getWidth() 
e double getHeight() 
返回 页 面 的 宽度 和 高 度 。 

è double getImageableWidth() 
ə double getImageableHeight() 

返回 可 打印 区 域 的 页 面 宽 度 和 高 度 。 
e double getImageablex() 
e double getImageableyY( ) 

返回 可 打印 区 域 的 左上 角 的 位 置 。 
e int getOrientation() 
返回 PORTARIT, LANDSCAPE 和 REVERSE_LANDSCAPE 三 者 之 一 。 页 面 打印 的 方 回 对 
程序 员 来 说 是 透明 的 ， 因 为 打印 格式 和 图 形 上 下 文 自动 地 反映 了 页 面 的 打印 方 同 。 


11.12.2 打印 多 页 文件 


在 实际 的 打印 操作 中 ， 通 常 不 应 该 将 原生 的 Printable 对 象 传递 给 打印 作业 。 相 反 ， 
应 该 获取 一 个 实现 了 Pageable 接口 的 类 的 对 象 。Java 平台 提供 了 这 样 的 一 个 被 称 为 Book 
的 类 。 一 本 书 是 由 很 多 章节 组 成 的 ， 而 每 个 章节 都 是 一 个 Printable 对 象 。 可 以 通过 添加 
Printable 对 象 和 相应 的 页 数 来 构建 一 个 Book 对 象 。 


Book book = new Book(); 

Printable coverPage=.. .; 

Printable bodyPages =.. .; 

book.append(coverPage, pageFormat); // append 1 page 
book.append(bodyPages, pageFormat, pageCount) ; 


然后 ， 可 以 使 用 setPageable 方法 把 Book 对 象 传 递 给 打印 作业 。 
printJob. setPageable (book) ; 


现在 ， 打 印 作业 就 知道 将 要 打印 的 确切 页 数 了 。 然 后 ， 打 印 对 话 框 显示 一 个 准确 的 页 面 
范围 ， 用 户 可 以 选择 整个 页 面 范围 或 可 选择 它 的 一 个 子 范围。 


QO 警告 当 打 印 作 业 调 用 Printable 章节 的 print 方法 时 ， 它 传递 的 是 该 书 的 当前 页 码 ， 
而 不 是 每 个 章节 的 页 码 。 这 让 人 非常 痛苦 ， 因 为 每 个 章节 必须 知道 它 之 前 所 有 章节 的 页 
数 ， 这 样 才能 使 得 页 码 参 数 有 意义 。 


从 程序 员 的 视角 来 看 ， 使 用 Book 类 最 大 的 挑战 就 是 ， 当 你 打印 它 时 ， 必 须知 道 每 一 个 
章节 究竟 有 多 少 页 。 你 的 Printable 类 需要 一 个 布局 算法 ， 以 便 用 来 计算 在 打印 页 面 上 的 
素材 的 布局 。 在 打印 开始 前 ， 要 调用 这 个 算法 来 计算 出 分 页 符 的 位 置 和 页 数 。 可 以 保留 此 布 
局 信息 ， 从 而 可 以 在 打印 的 过 程 中 方便 地 使 用 它 。 

必须 警惕 “用 户 已 经 修改 过 页 面 格式 ”这 种 情况 的 发 生 。 如 果 用 户 修 改 了 页 面 格式 ， 即 
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使 是 所 打印 的 信息 没有 发 生 任何 改变 ， 也 必须 要 重新 计算 布局 。 

程序 清单 11-13 中 显示 了 如 何 产生 一 个 多 页 打印 输出 。 该 程序 用 很 大 的 字符 在 多 个 页 面 
上 打印 了 一 条 消息 ( 见 图 11-35 )。 然 后 ， 可 以 剪 
裁 掉 页 边缘 ， 并 将 这 些 页 面 粘连 起 来 ， 形 成 一 个 
标语 。 

Banner 类 的 layoutPages 方法 用 以 计算 页 
面 的 布局 。 我 们 首先 展示 了 一 个 字体 为 72 磅 的 消 
息 字符 串 。 然 后 ， 我 们 计算 产生 的 字符 串 的 高 度 ， 
并 且 将 其 与 该 页 面 的 可 打印 高 度 进行 比较 。 我 们 
根据 这 两 个 高 度 值得 出 一 个 比例 因子 ， 当 打印 该 字符 串 时 ， 我 们 按照 比例 因子 来 放大 此 字符 
FB 


O BE: 如 有 果 要 准确 地 布局 打印 信息 ， 通 常 需要 访问 打印 机 的 图 形 上 下 文 。 遗 憾 的 是 ， 只 
有 当 打 印 真正 开始 时 ， 才 能 获得 打印 机 的 图 形 上 下 文 。 在 我 们 的 示例 程序 中 使 用 的 是 屏 
幕 的 图 形 上 下 文 ， 并 且 和 希望 屏幕 的 字体 度量 单位 与 打印 机 的 相 匹配 。 

Banner 类 的 getPageCount 方法 首先 调用 布局 方法 。 然 后 ， 扩 展 字 符 串 的 宽度 ， 并 且 
将 该 宽度 除 以 每 一 页 的 可 打印 宽度 。 得 到 的 商 向 
上 取 整 ， 就 是 要 打印 的 页 数 。 

由 于 字符 可 以 断 开 分 布 到 多 个 页 面 上 ， 所 以 


上 面 打印 标语 的 操作 好 像 会 有 困难 。 然 而 , 感谢 “二 下 





图 11-35 一 幅 标 语 


pr ae ~ r ; i ais y nat i ; iniia. : 


是 小 菜 一 碟 。 当 需要 打印 某 一 页 时 ， 我 们 只 需要 
调用 Graphics2D 类 的 translate 方 法 ， 将 字 





4 
oo i. 人 fr US SE oe OON . 
1 8s Wy oe t 


ERRE EMM ER BE. BR, RR poo 
当前 页 面 的 剪 切 矩形 (参见 图 11-36). RA, eee” 
们 用 布局 方法 计算 出 的 比例 因子 来 扩展 该 图 形 上 pe 

下 文 。 


这 个 例子 显示 了 图 形变 换 操 作 的 强大 功能 。 绘 图 代码 很 简单 ， 而 图 形变 换 操作 负责 执行 
将 图 形 放 到 恰当 位 置 上 的 所 有 操作 。 最 后 ， 剪 切 操作 负责 将 落 在 页 面 外 面 的 图 像 前 切 掉 。 在 
下 一 节 中 ， 你 将 看 到 另 一 种 必须 使 用 变换 操作 的 情况 ， 即 显示 页 面 的 打印 预览 。 


11.12.3 ”打印 预览 


大 多 数 专业 的 程序 都 有 一 个 打印 预览 机 制 ， 使 用 户 能 够 在 显示 屏幕 上 看 到 要 打印 的 页 
面 ， 这 样 就 不 必 为 不 满意 的 打印 输出 而 浪费 纸张 了 。Java 平台 的 打印 类 并 没有 提供 一 个 标准 
的 “打印 预览 ”对 话 框 ,但 是 可 以 非常 容易 地 设计 出 自己 的 打印 预览 对 话 框 (参见 
图 11-37 )。 在 本 节 中 ， 我 们 将 要 介绍 如 何 来 设计 自己 的 打印 预览 对 话 框 。 程 序 清单 11-14 中 
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fy PrintPreviewDialog 类 是 一 个 完全 泛 化 的 类 ， 你 可 以 复 用 它 来 预览 任何 种 类 的 打印 
输出 。 

如 果 要 构建 一 个 PrintPreviewDialog 类 ， 必 须 提 供 
一 个 Printable 或 Book， 并 且 还 要 提供 一 个 PageFormat 
对 象 。 对 话 框 包含 一 个 PrintPreviewCanvas (参见 程序 
清单 11-15 )。 当 使 用 Next 和 Previous 按钮 来 浏览 页 面 
时 ，paintComponent 方法 将 为 你 所 请 求 预览 的 页 面 调 用 
Printable 对 象 的 print 方法 。 

通常 ，print 方法 在 一 个 打印 机 的 图 形 上 下 文 上 绘制 页 
面 上 下 文 。 但 是 ， 我 们 提供 了 屏幕 的 图 形 上 下 文 ， 并 进行 了 
合适 的 缩放 ， 这 样 ， 打 印 的 整个 页 面 就 可 以 被 纳入 到 较 小 的 
屏幕 矩形 中 。 


float xoff =. . .; // left of page 

float yoff =. . .; // top of page 

float scale =. . .; // to fit printed page onto screen 
g2.translate(xoff, yoff); 

g2.scale(scale, scale); 

Printable printable = book.getPrintable(currentPage) ; 
printable.print(g2, pageFormat, currentPage) ; 


该 print 方法 从 来 都 不 知道 它 实 际 上 并 不 产生 打印 页 面 。 它 只 是 负责 在 图 形 上 下 文 上 进 
行 绘制 操作 ， 从 而 在 屏幕 上 产生 一 个 微观 的 打印 预览 。 这 非常 清楚 地 说 明了 Java 2D 图 像 模 
型 的 强大 功能 。 

程序 清单 11-12 中 包括 了 打印 标语 的 程序 代码 。 请 将 “ Hello, World! ”输入 到 文本 框 中 ， 
并 且 观 察 打印 预览 ， 然 后 把 标语 打印 输出 。 





图 11-37 打印 预览 对 话 框 





package book; 


1 
2 
3 import java.awt.*; 

4 import java.awt.print.*; 
5 

6 


import javax.print.attribute.*; 
7 import javax.swing.*; 


9 *k 

10 * This frame has a text field for the banner text and buttons for printing, page setup, and print 
11 * preview. 

2 */ 

13 public class BookTestFrame extends JFrame 

14 { 

15 private JTextField text; 

16 private PageFormat pageFormat; 

17 private PrintRequestAttributeSet attributes; 
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19 public BookTestFrame() 


20 { 

21 text = new JTextField(); 

22 add(text, BorderLayout. NORTH) ; 

23 

24 attributes = new HashPrintRequestAttributeSet() ; 

25 

26 JPanel buttonPanel = new JPanel (); 

27 

28 JButton printButton = new JButton("Print"); 

29 buttonPanel .add(printButton) ; 

30 printButton.addActionListener(event -> 

31 { 

32 try 

33 { 

34 PrinterJob job = PrinterJob.getPrinterJob() ; 
35 job. setPageabl e(makeBook()) ; 

36 if (job.printDialog(attributes)) 

37 

38 job.print(attributes) ; 

39 } 

40 } 

41 catch (PrinterException e) 

42 { 

43 JOptionPane.showMessageDi alog(BookTestFrame. this, e); 
44 } 

45 }); 

46 

47 JButton pageSetupButton = new JButton("Page setup"); 
48 buttonPanel .add(pageSetupButton) ; 

49 pageSetupButton. addActionListener(event -> 

50 

51 PrinterJob job = PrinterJob.getPrinterJob() ; 
52 pageFormat = job.pageDialog(attributes) ; 

53 }); 

54 

55 JButton printPreviewButton = new JButton("Print preview"); 
56 buttonPanel .add(printPreviewButton) ; 

57 printPreviewButton.addActionListener(event -> 

58 { 

59 PrintPreviewDialog dialog = new PrintPreviewDialog(makeBook()) ; 
60 dialog.setVisible(true) ; 

61 ys 

62 

63 add(buttonPanel, BorderLayout. SOUTH) ; 


64 pack(); 
} 


67 /** 

68 * Makes a book that contains a cover page and the pages for the banner. 
69 */ 

70 public Book makeBook() 

71 { 


72 if (pageFormat == null) 
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14 PrinterJob job = PrinterJob.getPrinterJob() ; 

15 pageFormat = job.defaultPage() ; 

76 

17 Book book = new Book(); 

78 String message = text.getText(); 

79 Banner banner = new Banner(message) ; 

80 int pageCount = banner.getPageCount((Graphics2D) getGraphics(), pageFormat) ; 

81 book. append(new CoverPage(message + " (" + pageCount + " pages)"), pageFormat) ; 
82 book.append(banner, pageFormat, pageCount) ; 

83 return book; 





package book; 


1 

2 

3 import java.awt.*; 

4 import java.awt.font.*; 
5 import java.awt.geom.*; 
6 import java.awt.print.*; 
7 

8 

9 


/** 
* A banner that prints a text string on multiple pages. 
10 */ 
11 public class Banner implements Printable 
n { 
13 private String message; 
1 private double scale; 


16 /** 

17 * Constructs a banner. 

18 * @param m the message string 
19 */ 

20 public Banner(String m) 

21 { 

22 message = m; 

23 } 

24 

25 /** 


26 * Gets the page count of this section. 

27 * @aram g2 the graphics context 

28 * @param pf the page format 

29 * @return the number of pages needed 

30 */ 

31 public int getPageCount(Graphics2D g2, PageFormat pf) 
{ 


33 if (message.equals("")) return 0; 

34 FontRenderContext context = g2.getFontRenderContext () ; 

35 Font f = new Font("Serif", Font.PLAIN, 72); 

36 Rectangle2D bounds = f.getStringBounds (message, context) ; 
37 scale = pf.getImageableHeight() / bounds.getHeight() ; 


38 double width = scale * bounds.getWidthQ; 





698 Java SRK KI ARAHI 


int pages = (int) Math.ceil(width / pf.getImageableWidth()); 
return pages; 


public int print(Graphics g, PageFormat pf, int page) throws PrinterException 


Graphics2D g2 = (Graphics2D) g; 
if (page > getPageCount(g2, pf)) return Printable.NO_SUCH_PAGE: 
g2.translate(pf.getImageableX(), pf.getImageableY()) ; 


drawPage(g2, pf, page); 
return Printable. PAGE_EXISTS;: 
} 


public void drawPage(Graphics2D g2, PageFormat pf, int page) 
{ 

if (message.equals("")) return; 

page--; // account for cover page 


drawCropMarks(g2, pf); 
g2.clip(new Rectangle2D.Double(0, 0, pf.getImageableWidth(), pf.getImageableHeight())); 
g2.translate(-page * pf.getImageableWidth(), 0); 
g2.scale(scale, scale); 
FontRenderContext context = g2.getFontRenderContext() ; 
Font f = new Font("Serif", Font.PLAIN, 72); 
TextLayout layout = new TextLayout(message, f, context); 
AffineTransform transform = AffineTransform.getTranslateInstance(0, layout.getAscent()); 
Shape outline = layout.getOutline(transform) ; 
g2.draw(outline) ; 
} 


/** 
* Draws 1/2" crop marks in the corners of the page. 
* @param g2 the graphics context 
* @param pf the page format 
* 
/ 
public void drawCropMarks(Graphics2D g2, PageFormat pf) 
{ 
final double C = 36; // crop mark length = 1/2 inch 
double w = pf.getImageableWidthQ) ; 
double h = pf.getImageabl eHei ght (); 
g2.draw(new Line2D.Double(0, 0, 0, Q); 
g2.draw(new Line2D.Double(0, 0, C, 0)); 
g2.draw(new Line2D.Double(w, 0, w, C)); 
g2.draw(new Line2D.Double(w, 0, w - C, 0)); 
g2.draw(new Line2D.Double(0, h, 0, h - ©); 


g2.draw(new Line2D.Double(0, h, C, h)); 
g2.draw(new Line2D.Double(w, h, w, h - C)); 
g2.draw(new Line2D.Double(w, h, w - C, h)); 


* This class prints a cover page with a title. 
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* 


class CoverPage implements Printable 


{ 
private String title; 


/** 

* Constructs a cover page. 
* @param t the title 

ki 

public CoverPage(String t) 
{ 

title = t; 

} 


public int print(Graphics g, PageFormat pf, int page) throws PrinterException 
{ 
if (page >= 1) return Printable.NO_SUCH_PAGE; 
Graphics2D g2 = (Graphics2D) g; 
g2.setPaint (Color.black) ; 
g2.translate(pf.getImageableX(), pf.getImageableY()) ; 
FontRenderContext context = g2.getFontRenderContext () ; 
Font f = g2.getFont(); 
TextLayout layout = new TextLayout(title, f, context); 
float ascent = layout.getAscent() ; 
g2.drawString(title, 0, ascent) ; 
return Printable. PAGE_EXISTS; 





package book; 


import java.awt.*; 
import java.awt.print.*; 


import javax.swing.*; 


kk 


* This class implements a generic print preview dialog. 
my 
public class PrintPreviewDialog extends JDialog 
{ 
private static final int DEFAULT_WIDTH = 300; 
private static final int DEFAULT_HEIGHT = 300; 


private PrintPreviewCanvas canvas; 


/** 
* Constructs a print preview dialog. 
* @param p a Printable 
* @aram pf the page format 
* @param pages the number of pages in p 
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D a A u N j 


*/ 


public PrintPreviewDialog(Printable p, PageFormat pf, int pages) 


Book book = new Book(); 
book.append(p, pf, pages); 
layoutUI (book) ; 


/** 

* Constructs a print preview dialog. 
* @param b a Book 

*} 


public PrintPreviewDialog(Book b) 


layoutUI (b) ; 


/** 
* Lays out the UI of the dialog. 
* @param book the book to be previewed 
” 
public void layoutUI(Book book) 
{ 
setSize(DEFAULT_WIDTH, DEFAULT_HEIGHT) ; 


canvas = new PrintPreviewCanvas (book) ; 
add(canvas, BorderLayout.CENTER) ; 


JPanel buttonPanel = new JPanel(); 


JButton nextButton = new JButton("Next"); 
buttonPanel .add(nextButton) ; 
nextButton.addActionListener(event -> canvas. flipPage(1)) ; 


JButton previousButton = new JButton("Previous"); 
buttonPanel .add(previousButton) ; 
previousButton. addActionListener(event -> canvas. flipPage(-1)); 


JButton closeButton = new JButton("Close"); 
buttonPanel .add(closeButton) ; 
closeButton.addActionListener(event -> setVisible(false)); 


add(buttonPanel, BorderLayout. SOUTH) ; 





package book; 


import java.awt.*: 
import java.awt.geom.*; 
import java.awt.print.*: 
import javax.swing.*; 
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* The canvas for displaying the print preview. 


class PrintPreviewCanvas extends JComponent 


{ 


private Book book; 
private int currentPage; 


/** 
* Constructs a print preview canvas. 
* @aram b the book to be previewed 
"j 
public PrintPreviewCanvas (Book b) 
{ 
book = b; 
currentPage = 0; 


} 


public void paintComponent (Graphics g) 
{ 
Graphics2D g2 = (Graphics2D) g; 
PageFormat pageFormat = book.getPageFormat (currentPage) ; 


double xoff; // x offset of page start in window 
double yoff; // y offset of page start in window 
double scale; // scale factor to fit page in window 
double px = pageFormat.getWidth(); 

double py = pageFormat.getHeight(); 

double sx = getWidth() - 1; 

double sy = getHeight() - 1; 

if (px / py < sx / sy) // center horizontally 

{ 


scale = sy / py; 
xoff = 0.5 * (sx - scale * px); 
yoff = 0; 
} 
else 
// center vertically 
{ 
scale = Sx / px; 
xoff = 0; 
yoff = 0.5 * (sy - scale * py); 


} 
g2.translate((float) xoff, (float) yoff); 
g2.scale((float) scale, (float) scale); 


// draw page outline (ignoring margins) 

Rectangle2D page = new Rectangle2D.Double(0, 0, px, py); 
g2.setPaint (Color.white) ; 

g2. fill (page) ; 

g2.setPaint (Color. black) ; 

g2.draw(page) ; 


Printable printable = book.getPrintable(currentPage) ; 





701 


702 Java ZSRR AI BAJ 


62 try 
63 { 

64 printable.print(g2, pageFormat, currentPage) ; 
65 

66 catch (PrinterException e) 

67 { 

68 g2.draw(new Line2D.Double(0, 0, px, py)); 

69 g2.draw(new Line2D.Double(px, 0, 0, py)); 

70 } 

71 } 

72 

73 /** 


74 * Flip the book by the given number of pages. 
75 * @aram by the number of pages to flip by. Negative values flip backward. 
* 


77 public void flipPage(int by) 
{ 


79 int newPage = currentPage + by; 

80 if (0 <= newPage && newPage < book. getNumberOfPages ()) 
81 { 

82 currentPage = newPage; 

83 repaint(); 

84 } 

85 } 

86 } 








e void setPageable(Pageable p) 
设置 一 个 要 打印 的 Pageable (比如 ， 一 个 Book)。 








evoid append(Printable p, PageFormat format) 

e void append(Printable p, PageFormat format, int pageCount ) 
为 该 书 添 加 一 个 章节 。 如 果 页 数 未 指定 ， 那 么 就 添加 第 一 页 。 

e Printable getPrintable(int page) 
获取 指定 页 面 的 可 打印 特性 。 


11.12.4 打印 服务 程序 


到 目前 为 止 ， 我 们 已 经 介绍 了 如 何 打 印 2D 图 形 。 然 而 ，Java SE 1.4 中 的 打印 API 提供 
了 更 大 的 灵活 性 。 该 API 定义 了 大 量 的 数据 类 型 ， 并 且 可 以 让 你 找到 能 够 打印 这 些 数据 类 型 
的 打印 服务 程序 。 这 些 类 型 有 : 

o GIF, JPEG 或 者 PNG 格式 的 图 像 。 

e 纯 文 本 、HTML PostScript 或 者 PDF 格式 的 文档 。 

o 原始 的 打印 机 代码 数据 。 
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e 实现 了 Printable, Pageable #% RenderableImage 的 某 个 类 的 对 象 。 

数据 本 身 可 以 存放 在 一 个 字 节 源 或 字符 源 中 ， 比 如 一 个 输入 流 、 一 个 URL 或 者 一 个 数 
组 中 。 文 档 风 格 (document flavor) 描述 了 一 个 数据 源 和 一 个 数据 类 型 的 组 合 。DocF1avor 
类 为 不 同 的 数据 源 定义 了 许多 内 部 类 ， 每 一 个 内 部 类 都 定义 了 指定 风格 的 常量 。 例 如 ， 常 量 

DocFlavor. INPUT_STREAM. GIF 

描述 了 从 输入 流 中 读 入 一 个 GIF 格式 的 图 像 。 表 11-3 中 列 出 了 数据 源 和 数据 类 型 的 各 种 组 合 。 

假设 我 们 想 打印 一 个 位 于 文件 中 的 GIF 格式 的 图 像 。 首 先 ， 确 认 是 否 有 能 够 处 理 该 打印 
任务 的 打印 服务 程序 。PrintServiceLookup 类 的 静态 lookupPrintServices 方法 返回 
一 个 能 够 处 理 给 定 文档 风格 的 PrintService 对 象 的 数组 。 


DocFlavor flavor = DocFlavor.INPUT_STREAM. GIF; 


PrintService[] services = PrintServiceLookup.]ookupPrintServices(flavor, null); 


表 11-3 打印 服务 的 文档 风格 





数据 源 数据 类 型 MIME 类 型 

INPUT_STREAM GIF image/gif 

URL JPEG image/jpeg 

BYTE_ARRAY PNG image/png 
POSTSCRIPT application/postscript 
PDF application/pdf 
TEXT_HML_HOST text/html (使 用 主机 编码 ) 
TEXT_HTML_US_ASCII text/html; charset=us-ascii 
TEXT_HTML_UTF_8 text/html; charset=utf-8 
TEXT_HTML_UTF_16 text/html; charset=utf-16 
TEXT_HTML_UTF_16LE text/html; charset=utf-161e (小 尾数 法 ) 
TEXT_HTML_UTF_16BE text/html; charset=utf-16be (大 尾数 法 ) 
TEXT_PLAIN_HOST text/plain (使 用 主机 编码 ) 
TEXT_PLAIN_US_ASCII text/plain; charset=us-ascii 
TEXT_PLAIN_UTF_8 text/plain; charset=utf-8 
TEXT_PLAIN_UTF_16 text/plain; charset=utf-16 
TEXT_PLAIN_UTF_16LE text/plain; charset=utf-l6le (小 尾数 法 ) 
TEXT_PLAIN_UTF_16BE text/plain; charset=utf—l6be (大 尾数 法 ) 
PCL application/vnd.hp-PCL (惠普 公司 打印 机 控制 语言 
AUTOSENSE application/octet-stream (原始 打印 数据 ) 

READER TEXT_HTML text/html; charset=utf-16 

STRING TEXT_PLAIN text/plain; charset=utf-16 

CHAR_ARRAY 

SERVICE_FORMATTED PRINTABLE 
PAGEABLE 





RENDERABLE_IMAGE 


无 
无 
无 
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lookupPrintServices 方法 的 第 二 个 参数 值 为 nu11， 表 示 我 们 不 想 通过 设 定 打 印 机 
属性 来 限制 对 文档 的 搜索 。 我 们 在 下 一 节 中 介绍 打印 机 的 属性 。 

如 果 对 打印 服务 程序 的 查找 返回 的 数组 带 有 多 个 元 素 的 话 ， 那 就 需要 从 打印 服务 程序 列 
表 中 选择 所 需 的 打印 服务 程序 。 通 过 调用 PrintService 类 的 getName 方法 ， 可 以 获得 打 
印 机 的 名 称 ， 然 后 让 用 户 进行 选择 。 

接着 ， 从 该 打印 服务 获取 一 个 文档 打印 作业 : 

DocPrintJob job = services[i].createPrintJob(); 

如 果 要 执行 打印 操作 ， 需 要 一 个 实现 了 Doc 接口 的 类 的 对 象 。Java 为 此 提供 了 一 个 
SimpleDoc 类 。Simp1eDoc 类 的 构造 器 必须 包含 数据 源 对 象 、 文 档 风 格 和 一 个 可 选 的 属性 
集 。 例 如 ， 


InputStream in = new FileInputStream(fileName) ; 
Doc doc = new SimpleDoc(in, flavor, null); 


最 后 ， 就 可 以 执行 打印 输出 了 。 

job.print(doc, null); 

与 前 面 一 样 ，null 参数 可 以 被 一 个 属性 集 取 代 。 

请 注意 ， 这 个 打印 进程 和 上 一 节 的 打印 进程 之 间 有 很 大 的 差异 。 这 里 不 需要 用 户 通过 打 
印 对 话 框 来 进行 交互 式 地 操作 。 例 如 ， 可 以 实现 一 个 服务 器 端的 打印 机 制 ， 这 样 ， 用 户 就 可 
以 通过 Web 表单 提交 打印 作业 了 。 
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程序 清单 11-16 中 的 程序 展示 了 如 何 使 用 打印 服务 程序 来 打印 一 个 图 像 文件 。 





package printService; 
import java.io.*; 


import java.nio.file.*; 
import javax.print.*; 


/** 
* This program demonstrates the use of print services. The program lets you print a GIF image to 
* any of the print services that support the GIF document flavor. 
* @ersion 1.10 2007-08-16 
* @author Cay Horstmann 
党 


public class PrintServiceTest 
public static void main(String[] args) 
DocFlavor flavor = DocFlavor.URL.GIF; 
PrintService[] services = PrintServiceLookup. lookupPrintServices(flavor, null); 


if (args. length == 0) 
{ 


if (services. length == 0) System.out.printIn("No printer for flavor " + flavor); 
else 
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23 { 

24 System.out.println("Specify a file of flavor " + flavor 

25 + "\nand optionally the number of the desired printer."); 
26 for (int i = 0; i < services.length; i++) 

27 System.out.printin((i + 1) +": " + services[i].getName()) ; 
28 } 

29 System.exit(0); 

30 

31 String fileName = args[0]; 

32 int p= 1; 

3 if (args.length > 1) p = Integer.parseInt(args[1]); 

34 if (fileName == null) return; 

35 try (InputStream in = Files.newInputStream(Paths.get (fileName) )) 
36 { 

37 Doc doc = new SimpleDoc(in, flavor, null); 

38 DocPrintJob job = services[p - 1].createPrintJob() ; 

39 job.print(doc, null); 

40 } 

41 catch (Exception ex) 

42 { 

43 ex. printStackTrace() ; 





ePrintService[] lookupPrintServices(DocFlavor flavor, AttributeSet 
attributes) 
查找 能 够 处 理 给 定 文档 风格 和 属性 的 打印 服务 程序 。 


参数 : Flavor 文档 风格 
attributes 需要 的 打印 属性 ， 如 果 不 考虑 打印 属性 的 话 ， 其 值 应 该 为 
null 





e DocPrintJob createPrintJob( ) 
为 了 打印 实现 了 Doc 接口 (如 SimpleDoc) 的 对 象 而 创建 一 个 打印 作业 。 


e void print(Doc doc, PrintRequestAttributeSet attributes) 
打印 带 有 给 定 属性 的 给 定 文档 。 


参数 . doc 要 打印 的 Doc 
attributes 需要 的 打印 属性 ， 如 果 不 需 要 任何 打印 属性 的 话 ， 其 值 为 
null 
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eSimpleDoc(Object data, DocFlavor flavor, DocAttributeSet 


attributes) 

构建 一 个 能 够 用 DocPrintJob 打印 的 Simp1eDoc 对 象 。 

参数 : data 带 有 打印 数据 的 对 象 ， 比 如 一 个 输入 流 或 者 一 个 Printable 
flavor 打印 数据 的 文档 风格 


attributes 文档 属性 ， 如 果 不 需 要 文档 属性 ， 其 值 为 nul11 


11.12.5 ” 流 打印 服务 程序 


打印 服务 程序 将 打印 数据 发 送 给 打印 机 。 流 打印 服务 程序 产生 同样 的 打印 数据 ， 但 是 并 
不 把 数据 发 送 给 打印 机 ， 而 是 发 给 流 。 这 么 做 的 目的 也 许 是 为 了 延迟 打印 或 者 因为 打印 数据 
格式 可 以 由 其 他 程序 来 进行 解释 。 尤 其 是 ， 如 果 打 印 数据 格式 是 PostScript At, 那么 可 将 
打印 数据 保存 到 一 个 文件 中 ， 因 为 有 许多 程序 都 能 够 处 理 PostScript 文件 。Java 平台 引入 
了 一 个 流 打 印 服务 程序 ， 它 能 够 从 图 像 和 2D 图 形 中 产生 PostScript 输出 。 可 以 在 任何 系 
统 中 使 用 这 种 服务 程序 ， 即 使 这 些 系统 中 没有 本 地 打印 机 ， 也 可 以 使 用 该 服务 程序 。 

枚 举 流 打印 服务 程序 要 比 定位 普通 的 打印 服务 程序 复杂 一 些 。 既 需要 打印 对 象 的 
DocFlavor 又 需要 流 输 出 的 MIME 类 型 ， 接 着 获得 一 个 StreamPrintServiceFactory 类 
型 的 数组 ， 如 下 所 示 : 


DocFlavor flavor = DocFlavor.SERVICE_FORMATTED. PRINTABLE; 
String mimeType = "“application/postscript"; 
StreamPrintServiceFactory[] factories 
= StreamPrintServiceFactory.lookupStreamPrintServiceFactories(flavor, mimeType) ; 


StreamPrintServiceFactory 类 没有 任何 方法 能 够 帮助 我 们 区 分 不 同 的 factory, 
所 以 我 们 只 提取 factories[0]。 我 们 调用 带 有 输出 流 参数 的 getPrintService 方法 来 获 
得 一 个 StreamPrintService 对 象 。 


OutputStream out = new FileQutputStream(fi]eName) ; 
StreamPrintService service = factories [0] .getPrintService(out) ; 


StreamPrintService 类 是 PrintService 的 子 类 。 如 果 要 产生 一 个 打印 输出 ， 只 要 
按照 上 一 节 介 绍 的 步骤 进行 操作 即 可 。 


4 





e StreamPrintServiceFactory[] lookupStreamPrintServiceFactories(DocF 
lavorflavor, StringmimeType) 
查找 所 需 的 流 打 印 服务 程序 工厂 ， 它 能 够 打印 给 定 文档 风格 ， 并 且 产 生 一 个 给 定 
MIME 类 型 的 输出 流 。 


è StreamPrintService getPrintService(OutputStream out) 
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获得 一 个 打印 服务 程序 ， 以 便 将 打印 输出 发 送 到 指定 的 输出 流 中 。 


11.12.6 ”打印 属性 


打印 服务 程序 API 包含 了 一 组 复杂 的 接口 和 类 ， 用 以 设 定 不 同 种 类 的 属性 。 重 要 的 属性 
共有 四 组 ， 前 两 组 属性 用 于 设 定 对 打印 机 的 访问 请 求 。 

o 打印 请 求 属性 (Print request attribute) 为 一 个 打印 作业 中 的 所 有 doc 对 象 请 求 特定 的 打 
印 属性 ， 例 如 ， 双 面 打印 或 者 纸张 的 大 小 。 

e Doc 属性 (Doc attribute) 是 仅 作用 在 单个 doc 对 象 上 的 请 求 属 性 。 

另外 两 组 属性 包含 关于 打印 机 和 作业 状态 的 信息 。 

o 打印 服务 属性 (Print service attribute) 提供 了 关于 打印 服务 程序 的 信息 ， 比 如 打印 机 的 
种 类 和 型 号 ， 或 者 打印 机 当前 是 否 接受 打印 作业 。 

o 打印 作业 属性 (Print job attribute) 提供 了 关于 某 个 特定 打印 作业 状态 的 信息 ， 比 如 该 
打印 作业 是 否 已 经 完成 。 

如 果 要 描述 各 种 不 同 的 打印 属性 ， 可 以 使 用 带 有 如 下 子 接口 的 Attribute 接口 。 


printRequestAttribute 
DocAttribute 
printServiceAttribute 
PrintJobAttribute 
SupportedValuesAttri bute 


各 个 属性 类 都 实现 了 上 面 的 一 个 或 几 个 接口 。 例 如 ，Copies 类 的 对 象 描述 了 一 个 打印 
输出 的 拷贝 数量 ， 该 类 就 实现 了 PrintRequestAttribute 和 PrintJobAttribute 两 个 接 
口 。 显 然 ， 一 个 打印 请 求 可 以 包含 一 个 需要 多 个 拷贝 的 请 求 。 反 过 来 ， 打 印 作业 的 某 个 属性 
可 能 表示 的 是 实际 上 打印 出 来 的 拷贝 数量 。 这 个 拷贝 数量 可 能 很 小 ， 也 许 是 因为 打印 机 的 限 
制 或 者 是 因为 打印 机 的 纸张 已 经 用 完了 。 

SupportedValuesAttribute 接口 表示 某 个 属性 值 反映 的 不 是 实际 的 打印 请 求 或 状 
态 数据 ， 而 是 某 个 服务 程序 的 能 力 。 例 如 ， 实 现 了 SupportedValuesAttribute 接口 的 
CopiesSupported 类 ， 该 类 的 对 象 可 以 用 来 描述 某 个 打印 机 能 够 支持 1 ~ 99 份 拷贝 的 打印 输出 。 

图 11-38 显示 了 属性 分 层 结构 的 类 图 。 

除了 为 各 个 属性 定义 的 接口 和 类 以 外 ， 打 印 服务 程序 API 还 为 属性 集 定 义 了 接口 和 类 。 
父 接口 AttributeSet 有 四 个 子 接口 : 


PrintRequestAttributeSet 
DocAttributeSet 
PrintServiceAttributeSet 
PrintJobAttributeSet 


对 于 每 个 这 样 的 接口 ， 都 有 一 个 实现 类 ， 因 此 会 产生 下 面 5 个 类 : 


HashAttributeSet 
HashprintRequestAttributeSet 
HashDocAttributeSet 
HashPrintServiceAttributeSet 
HashPrintJobAttributeSet 
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图 11-38 显示 了 一 个 属性 层次 结构 的 类 图 
图 11-39 显示 了 属性 集 分 层 结构 的 类 图 。 





图 11-39 属性 集 的 分 层 结构 
例如 ， 可 以 用 如 下 的 方式 构建 一 个 打印 请 求 属性 集 。 


PrintRequestAttributeSet attributes = new HashPrintRequestAttributeSet() ; 

当 构 建 完 属性 集 后 ， 就 不 用 担心 使 用 Hash 前 级 的 问题 了 。 

为 什么 要 配 有 所 有 这 些 接口 呢 ? 因为 ， 它 们 使 得 “检查 属性 是 否 被 正确 使 用 ”成 为 了 可 
能 。 例 如 ，DocAttributeSet 只 接受 实现 了 DocAttribute 接口 的 对 象 ， 添 加 其 他 属性 的 
任何 尝试 都 会 导致 运行 期 错误 的 产生 。 

属性 集 是 一 个 特殊 的 映射 表 ， 其 键 是 Class 类 型 的 ， 而 值 是 一 个 实现 了 Attribute 接 
口 的 类 。 例 如 ， 如 果 要 插入 一 个 对 象 
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new Copies(10) 


到 属性 集中 ， 那 么 它 的 键 就 是 Class 对 象 Copies .class。 该 键 被 称 为 属性 的 类 别 。 
Attribute 接口 声明 了 下 面 这 样 一 个 方法 : 

Class getCategory() 

该 方法 就 可 以 返回 属性 的 类 别 。Copies 类 定义 了 用 以 返回 Copies .class 对 象 的 方法 。 
但 是 ， 属 性 的 类 别 和 属性 的 类 没有 必要 是 相同 的 。 

当 将 一 个 属性 添加 到 属性 集中 时 ， 属 性 的 类 别 就 会 被 自动 地 获取 。 你 只 需 添加 该 属性 的 值 : 

attributes.add(new Copies(10)); 


如 果 后 来 添加 了 一 个 具有 相同 类 别 的 另 一 个 属性 ， 那 么 新 属性 就 会 覆盖 第 一 个 属性 。 如 
果 要 检索 一 个 属性 ， 需 要 使 用 它 的 类 别 作为 键 ， 例 如 ， 


AttributeSet attributes = job.getAttributes(); 
Copies copies = (Copies) attribute.get(Copies.class); 


最 后 ， 属 性 是 按照 它们 拥有 的 值 来 进行 组 织 的 。Copies 属性 能 够 拥有 任何 整数 值 。 
Copies 类 继承 了 IntegerSyntax 类 ,该 类 负责 处 理 所 有 带 有 整数 值 的 属性 。getValue 方 
法 将 返回 属性 的 整数 值 ， 例 如 ， 


int n = copies.getValue(); 
下 面 这 些 类 . 


TextSyntax 
DateTimeSyntax 
URISyntax 


用 于 封装 一 个 字符 串 、 日 期 与 时 间 ， 或 者 URI (通用 资源 标识 符 )。 
最 后 要 说 明 的 是 ， 许 多 属性 都 能 够 接受 数量 有 限 的 值 。 例 如 ，PrintQuality 属性 有 三 
个 设置 值 : draft (草稿 质量 )，normal (正常 质量 ) M high (高 质量 )， 它 们 用 三 个 常量 来 表示 : 


PrintQuality.DRAFT 
PrintQuality. NORMAL 
PrintQuality.HIGH 


拥有 有 限 数量 值 的 属性 类 继承 了 EnumSyntax 类 ， 该 类 提供 了 许多 便利 的 方法 ， 用 来 以 
类 型 安全 的 方式 设置 这 些 枚 举 。 当 使 用 这 样 的 属性 时 ， 不 必 担 心 该 机 制 ， 只 需要 将 带 有 名 字 
的 值 添加 给 属性 集 即 可 : 

attributes.add(PrintQuality.HIGH) ; 

下 面 的 代码 说 明了 如 何 来 检查 一 个 属性 的 值 : 


if (attributes.get(PrintQuality.class) == PrintQuality.HIGH) 


# 11-4 列 出 了 各 个 打印 属性 。 表 中 的 第 二 列 列 出 了 属性 类 的 超 类 (例如 ，Copies 属性 
的 IntegerSyntax 类 ) 或 者 是 具有 一 组 有 限 值 属性 的 枚 举 值 。 最 后 四 列表 示 该 属性 是 否 实 
现 了 DocAttribute (DA),PrintJobAttribute (PJA),PrintRequestAttribute (PRA) 
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All PrintServiceAttribute (PSA) 几 个 接口 。 
表 11-4 打印 属性 一 览 表 


ae | OOO o a p 
cotorsupported | suPronren, wise | | | Vv 
Compression [cowrness, oeruare, ee fv) | 
DocunentNane Casma VP 


Fidelity FIDELITY_TRUE, FIDELITY_FALSE 
Finishings NONE, STAPLE, EDGE_STITCH, BIND, SADDLE_| V 


本 
< 


gs 


ss 


qs < 
kk < 


Nn 

一 

= 

一 

O 

= 
a 


O 
O 
< 
m 
wa 


JobHolduUntil DateTimeSyntax 


< 


JobImpressions IntegerSyntax 
JobImpressionsCompleted IntegerSyntax 


JobKOctets IntegerSyntax 


< 
< 


JobKOctetsProcessed IntegerSyntax 
JobMediaSheets IntegerSyntax 
JobMediaSheetsCompleted IntegerSyntax 


JobMessageFromOperator TextSyntax 










BE 
Hi 
Tasma o 
JobState ABORTED, CANCELED, COMPLETED, PENDING, V/ 
PENDING_HELD, PROCESSING, PROCESSING_STOPPED ve 
JobStateReason ABORTED_BY_SYSTEM, DOCUMENT_FORMAT_ERROR, 
ws P| | 
MediaName ISO_A4_WHITE, ISO_A4_TRANSPARENT, NAJ v y7 V 
LETTER_WHITE, NA_LETTER_TRANSPARENT id 
MediaSize ISO.AO-ISO.A10, ISO.BO-ISO.B10, ISO.CO-ISO. 






C10, NA.LETTER, NA.LEGAL, 各 种 其 他 纸张 和 信封 尺寸 
ISO_AO-ISO_A10, ISO_BO-ISO_B10, ISO_C0- 
ISO_C10, NA_LETTER, NA_LEGAL, 各 种 其 他 纸张 和 


viviyv 
信封 尺寸 名 称 


MediaTray TOP, MIDDLE, BOTTOM, SIDE, ENVELOPE, LARGE_| vV V V 
CAPACITY, MAIN, MANUAL 






MediaSizeName 












属 性 
MultipleDocumentHandling 


NumberOfDocuments 
NumberOfInterveningJobs 
NumberUp 


OrientationRequested 


OutputDeviceAssigned 
PageRanges 
PagesPerMinute 
PagesPerMinuteColor 
PDLOverrideSupported 


PresentationDirection 


PrinterInfo 
PrinterIsAcceptingJobs 
PrinterLocation 
PrinterMakeAndModel 
PrinterMessageF romOperator 
PrinterMoreInfo 
PrinterMoreInfoManufacturer 
PrinterName 
PrinterResolution 
PrinterState 
PrinterStateReason 
PrinterStateReasons 
PrinterURI 

PrintQuality 
QueuedJobCount 
ReferenceUr i SchemesSupported 


RequestingUserName 
Severity 
SheetCollate 

Sides 
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超 类 或 枚 举 常 量 


SINGLE_DOCUMENT, SINGLE_DOCUMENT_NEW_SHEET, 
SEPARATE_DOCUMENTS_COLLATED_COPIES, SEPARATE_ 
DOCUMENTS_UNCOLLATED_COPIES 





IntegerSyntax 
IntegerSyntax 
IntegerSyntax 


PORTRAIT, LANDSCAPE, REVERSE_PORTRAIT, 
REVERSE_LANDSCAPE 


TextSyntax 

‘SetOfInteger 
IntegerSyntax 
IntegerSyntax 

ATTEMPTED, NOT_ATTEMPTED 


TORIGHT_TOBOTTOM, TORIGHT_TOTOP, TOBOTTOM_ 
TORIGHT, TOBOTTOM_TOLEFT, TOLEFT_TOBOTTOM, 
TOLEFT_TOTOP, TOTOP_TORIGHT, TOTOP_TOLEFT 







TextSyntax 

ACCEPTING_JOBS, NOT_ACCEPTING_JOBS 
TextSyntax 

TextSyntax 

TextSyntax 

URISyntax 

URISyntax 

TextSyntax 

ResolutionSyntax 

PROCESSING, IDLE, STOPPED, UNKNOWN 
COVER_OPEN, FUSER_OVER_TEMP, MEDIA_JAM, 其 他 


URISyntax 
DRAFT, NORMAL, HIGH 


IntegerSyntax 

FILE, FTP, GOPHER, HTTP, HTTPS, NEWS, NNTP, 
WAIS 

TextSyntax 

ERROR, REPORT, WARNING 

COLLATED, UNCOLLATED 


ONE_SIDED, DUPLEX (= TWO_SIDED_LONG_EDGE), 
TUMBLE (= TWO_SIDED_SHORT_EDGE ) 





¢ SRAWT 71l 


< 


< 
本 De tells 
Se Tit tT tise TT a Pte} 


KISIS 


S151 11S | SSS 


< 


712 Java ZSR Al ZRH 


注意 : 可 以 看 到 ， 属 性 的 数量 很 多 ， 其 中 许多 属性 都 是 专用 的 。 大 多 数 属 性 都 来 源 于 因 
特 网 打印 协议 1.1 版 (RFC 2911 ) 。 


注意 : 打印 API 的 早期 版 本 引入 了 JobAttributes 和 PageAttributes 类 ， 其 目的 与 
本 节 所 介绍 的 打印 属性 类 似 。 这 些 类 现在 已 经 弃 用 了 。 





eClass getCategory() 
获取 该 属性 的 类 别 。 
e String getName() 


获取 该 属性 的 名 字 。 





e boolean add(Attribute attr) 
四 属性 集中 添加 一 个 属性 。 如 果 集 中 有 另 一 个 属性 和 此 属性 有 相同 的 类 别 ， 那 么 集中 的 
属性 被 新 添加 的 属性 所 取代 。 如 果 由 于 添加 属性 的 操作 改变 了 属性 集 ， 则 返回 true。 

e Attribute get(Class category) 
检索 带 有 指定 属性 类 别 键 的 属性 ， 如 果 该 属性 不 存在 ， 则 返回 null, 

e boolean remove(Attribute attr) 

e boolean remove(Class category) 

从 属性 集中 删除 给 定 属性 ， 或 者 删除 具有 指定 类 别 的 属性 。 如 果 由 于 这 个 操作 改变 了 
属性 集 ， 则 返回 true。 

e Attribute[] toArray() 

BESRA ARER RA R ERR 





e PrintServiceAttributeSet getAttributes() 
获取 打印 服务 程序 的 属性 。 








è PrintJobAttributeSet getAttributes() 
获取 打印 作业 的 属性 。 
我 们 就 要 结束 关于 打印 的 讨论 了 。 现 在 ， 读 者 已 经 知道 应 该 如 何 打 印 2D 图 形 和 其 他 文 
档 类 型 ， 怎 样 枚 举 各 种 打印 机 和 流 打 印 服 务 程序 ， 以 及 如 何 设置 和 获取 打印 属性 。 接 下 来 ， 
我 们 将 介绍 两 个 重要 的 用 户 接口 问题 : 剪贴 板 和 拖 放 机 制 。 


11.13 ZNR 


在 图 形 用 户 界 面 环境 (比如 Windows 和 X Window AZ) 中 ， 剪 切 和 拷贝 是 最 有 用 和 最 
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方便 的 用 户 接口 机 制 之 一 。 你 可 以 在 某 个 程序 中 选择 一 些 数据 ， 将 它们 剪 切 或 者 拷贝 到 剪贴 
板 上 。 然 后 选择 另 一 个 程序 ， 将 剪 切 板 中 的 内 容 粘贴 到 该 应 用 中 去 。 使 用 剪贴 板 ， 可 以 把 文 
本 、 图 像 或 者 别 的 数据 从 一 个 文档 移动 到 另 一 个 文档 中 ， 当 然 也 可 以 从 文档 的 一 个 地 方 移动 
到 该 文档 的 另 一 个 地 方 。 剪 切 和 粘贴 操作 是 如 此 普通 ， 以 至 于 大 多 数 计算 机 的 用 户 从 来 都 设 
有 考虑 过 它 究竟 是 如 何 实现 的 。 

尽管 前 贴 板 从 概念 上 来 说 是 非常 简单 的 ， 但 是 实现 剪贴 板 服务 却 比 想象 中 的 要 困难 得 
多 。 假 设 你 将 文本 从 字 处 理 程序 拷贝 到 了 剪贴 板 ， 如 果 你 要 将 该 文本 粘贴 到 另 一 个 字 处 理 程 
序 中 ,那么 肯定 希望 该 文本 的 字体 和 格式 保持 原样 。 也 就 是 说 ， 剪 贴 板 中 的 文本 必须 保留 原 
来 的 格式 信息 。 但 是 如 果 要 将 该 文本 信息 粘贴 到 一 个 纯 文 本 域 中 ， 那 么 你 希望 只 粘贴 文本 字 
符 ， 而 不 包括 附加 的 格式 代码 。 为 了 支持 这 种 灵活 性 ， 数 据 提供 者 可 以 提供 多 种 格式 的 剪贴 
板 数 据 ， 而 数据 使 用 者 可 以 从 多 种 格式 中 选择 所 需要 的 格式 。 

微软 公司 的 Windows 和 苹果 公司 的 Macintosh 等 操作 系统 的 剪贴 板 实现 方法 是 类 似 的 。 
当然 ， 它 们 之 间 会 有 略微 的 不 同 。 然 而 ，X Window 系统 的 剪贴 板 机 制 的 功能 是 非常 有 限 的 。 
它 只 支持 纯 文 本 的 前 切 和 粘贴 。 当 你 试图 运行 本 节 中 的 程序 时 ， 应 该 考虑 它 的 这 些 局 限 性 。 
图 注意 : 请 查看 你 的 平台 上 的 jre/1ib/flavormap.properties 文件 ， 以 便 得 知 关于 哪 

些 类 型 的 对 象 能 够 在 Java 程序 和 系统 剪贴 板 之 间 进 行 传递 。 

通常 ， 程 序 应 该 支持 对 系统 剪贴 板 不 能 处 理 的 那些 数据 类 型 的 剪 切 和 粘贴 。 数 据 传递 
API 支持 任何 本 地 对 象 引用 在 同一 个 虚拟 机 中 的 传递 ， 而 在 不 同 的 虚拟 机 之 间 ， 可 以 将 序列 
化 对 象 和 对 象 的 引用 传递 给 远程 对 象 。 

表 11-5 汇总 了 剪贴 板 机 制 的 数据 传递 能 力 。 

表 11-5 Java 数据 传递 机 制 的 能 力 


传递 方式 传递 的 信息 格式 
在 一 个 Java 程序 和 一 个 本 地 程序 之 间 传 递 LE, FAR. 文件 列表 …… (依赖 于 本 机 平台 ) 
在 两 个 协同 操作 的 Java 程序 之 间 传 递 序列 化 和 远程 对 象 
在 一 个 Java 程序 的 内 部 传递 任意 对 象 


11.13.1 用 于 数据 传递 的 类 和 接口 


在 Java 技术 中 ，java.awt .datatransfer 包 实 现 了 数据 传递 的 功能 。 下 面 就 是 该 包 中 
最 重要 的 类 和 接口 的 概述 。 
o 能 够 通过 剪贴 板 来 传递 数据 的 对 象 必 须 实现 Transferable 接口 。 
e Clipboard 类 描述 了 一 个 剪贴 板 。 可 传递 的 对 象 是 唯一 可 以 置 于 剪贴 板 之 上 或 者 从 前 
贴 板 上 取 走 的 项 。 系 统 前 贴 板 是 C1ipboard 类 的 一 个 具体 实例 。 

e DataF lavor 类 用 来 描述 存放 到 剪贴 板 中 的 数据 风格 。 

e StringSelection 类 是 一 个 实现 了 transferable 接口 的 实体 类 。 它 用 于 传递 文本 字符 串 。 
o 当前 贴 板 的 内 容 被 别人 改写 时 ， 如 果 一 个 类 想得到 这 种 情况 的 通知 ， 那 么 就 必须 实现 
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ClipboardOwner 接口 。 剪 贴 板 的 所 有 权 实 现 了 复杂 数据 的 “延迟 格式 化 ”" 。 如 果 一 
个 程序 传递 的 是 一 个 简单 数据 (比如 一 个 字符 串 )， 那 么 它 只 需要 设置 剪贴 板 的 内 容 ， 
然后 就 可 以 继续 进行 接 下 来 的 操作 了 。 但 是 ， 如 果 一 个 程序 想 把 能 够 用 多 种 风格 来 格 
式 化 的 复杂 数据 放 到 剪贴 板 上 ， 那 么 它 实 际 上 并 不 需要 为 此 准备 所 有 的 风格 ， 因 为 大 
多 数 的 风格 是 从 来 不 会 被 用 到 的 。 不 过 ， 这 时 必须 保存 剪贴 板 中 的 数据 ， 这 样 就 能 在 
以 后 被 请 求 的 时 候 ， 建 立 所 需 的 风格 。 当 剪贴 板 的 内 容 被 更 改 时 ， 前 贴 板 的 所 有 者 必 
须 得 到 通知 (通过 调用 lostOwnership 方法)。 这 样 可 以 告诉 它 ， 这 些 信息 已 经 不 再 
需要 了 。 在 我 们 的 示例 程序 中 ， 并 不 用 担心 剪贴 板 的 所 有 权 问 题 。 


11.13.2 传递 文本 


如 采 要 了 解数 据 传递 类 ， 最 好 的 方法 就 是 从 最 简单 的 情况 开始 : 即 在 系统 剪贴 板 上 传递 
和 获取 文本 信息 。 首 先 ， 获 取 一 个 系统 剪贴 板 的 引用 |: 


Clipboard clipboard = Too1kit,getDefaultToo1kit() ,getSystemC1ipboard()， 
传递 给 剪贴 板 的 字符 串 ， 必 须 被 包装 在 StringSelection 对 象 中 。 


String text=...3 
StringSelection selection = new StringSelection(text) ; 


实际 的 传递 操作 是 通过 调用 setContents 方法 来 实现 的 ， 该 方法 将 一 个 String- 
Selection 对 象 和 一 个 C1ipBoardOwner 作为 参数 。 如 果 不 想 指 定 剪贴 板 所 有 者 的 话 ， 可 
以 把 第 二 个 参数 设置 为 nu11。 


clipboard. setContents (selection, null); 


下 面 是 反 过 来 的 操作 :从 剪贴 板 中 读 取 一 个 字符 串 : 


DataFlavor flavor = DataFlavor.stringFlavor; 
if (clipboard. isDataFlavorAvai lable(flavor) 
String text = (String) clipboard.getData(flavor) ; 


程序 清单 11-17 展示 了 如 何在 一 个 java 应 用 和 系统 剪贴 板 之 间 进 行 剪 切 和 粘贴 操作 。 如 

末 你 选择 文本 区 域 中 的 一 块 文本 区 域 ， 并 且 点 击 Copy， 那 么 选中 的 文本 就 会 被 拷贝 到 系统 

鸡 贴 板 中 ， 然 后 可 以 将 其 粘贴 到 任何 文本 编辑 器 中 (参见 图 11-40 )。 反 之 ， 当 从 文本 编辑 器 

中 拷贝 文本 时 ， 也 可 以 将 其 粘贴 到 我 们 的 示例 程序 中 。 
leransierest ICT] 四 
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package transferText; 


import java.awt.*; : 
import java.awt.datatransfer.*; 
import java.awt.event.*; 

import java.i0.*; 

import javax.swing.*; 


AD o ē N oOo tm A w N | 一 


[** 

10 * This frame has a text area and buttons for copying and pasting text. 
u */ 

1 public class TextTransferFrame extends JFrame 

3 { 

14 private JTextArea textArea; 

15 private static final int TEXT_ROWS = 20; 

16 private static final int TEXT_COLUMNS = 60; 


18 public TextTransferFrame() 


19 { 

20 textArea = new JTextArea(TEXT_ROWS, TEXT_COLUMNS) ; 
21 add(new JScrol]Pane(textArea), BorderLayout.CENTER) ; 
22 JPanel panel = new JPanel (); 

23 

24 ]Button copyButton = new JButton("Copy") ; 

25 panel .add(copyButton) ; 

26 copyButton.addActionListener(event -> copy()); 

27 

28 }Button pasteButton = new JButton("Paste"); 

29 panel .add(pasteButton) ; 

30 pasteButton.addActionListener(event -> paste()); 

31 

32 add(panel, BorderLayout. SOUTH) ; 

33 pack(); 

34 } 

35 

36 /* 

37 * Copies the selected text to the system clipboard. 

38 */ 

39 private void copy() 

40 { 

41 Clipboard clipboard = Toolkit. getDefaultTool kit() .getSystem(1i pboard() ; 
42 String text = textArea.getSelectedText() ; 

43 if (text == null) text = textArea.getText() ; 

44 StringSelection selection = new StringSelection(text) ; 
45 clipboard.setContents(selection, null); 

46 } 

47 

48 fas 

49 * Pastes the text from the system clipboard into the text area. 
50 */ 


sı private void paste() 


52 { 





716 Java ZSRR A BAH 


53 Clipboard clipboard = Toolkit.getDefaultToolkit() .getSystemClipboard() ; 
54 DataFlavor flavor = DataFlavor.stringFlavor; 

55 if (clipboard.isDataFlavorAvailable(flavor)) 

56 

57 try 

58 { 

59 String text = (String) clipboard.getData(flavor) ; 
60 textArea. replaceSelection(text) ; 

61 } 

62 catch (UnsupportedFlavorException e | IOException ex) 
63 { 

64 JOptionPane.showMessageDialog(this, ex); 

65 

66 } 

67 } 

68 } 








eClipboard getSystemClipboard() 1.1 
获取 系统 剪贴 板 。 





e Transferable getContents(Object requester) 


获取 剪贴 板 中 的 内 容 。 
参数 : requester 请 求 剪贴 板 内 容 的 对 象 ; 该 值 实际 上 并 不 使 用 


e void setContents(Transferable contents, ClipboardOwner owner) 


将 内 容 放 人 剪贴 板 中 。 
Až: contents 封装 了 内 容 的 Transferable 
owner 当 新 的 信息 被 放 人 剪贴 板 上 时 ， 要 通知 的 对 象 (通过 调用 


lostOwnership 方法 )。 如 果 不 需要 通知 ， 则 值 为 nu11 


eboolean isDataFlavorAvailable(DataFlavor flavor) 5.0 


如 果 该 剪贴 板 中 有 给 定 风格 的 数据 ， 那 么 返回 true, 
e Object getData(DataFlavor flavor) 5.0 


获取 给 定 风 格 的 数据 ， 如 果 给 定 风 格 的 数据 不 存在 ， 则 抛 出 UnsupportedF lavor- 
Exception 异常 。 





evoid lostOwnership(Clipboard clipboard, Transferable contents) 
通知 该 对 象 ， 它 已 经 不 再 是 该 剪贴 板 内 容 的 所 有 者 。 
参数 : clipboard 已 放置 内 容 的 剪贴 板 
contents 该 所 有 者 放 人 剪贴 板 上 的 内 容 
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e boolean isDataFlavorSupported(DataFlavor flavor) 


如 果 给 定 的 风格 是 所 文 持 的 数据 风格 中 的 一 种 ， 则 返回 true， 人 否则 返回 false. 
e Object getTransferData(DataFlavor flavor) 


返回 用 所 请 求 风 格格 式 化 的 数据 。 如 果 不 支 持 所 请 求 的 风格 ， 则 抛 出 一 个 Unsupported- 
FlavorException 异常 。 


11.13.3 Transferable 接口 和 数据 风格 


DataFlavor 是 由 下 面 两 个 特性 来 定义 的 : 
o MIME 类 型 的 名 字 (比如 "image/gif")。 
e 用 于 访问 数据 的 表示 类 (比如 java.awt.Image)。 
此 外 ， 每 一 种 数据 风格 都 有 一 个 适合 人 类 阅读 的 名 字 (比如 "GIF Image"). 
表示 类 可 以 用 MIME 类 型 的 class 参数 设 定 ， 例 如 ， 
image/gif;class=java.awt. Image 
注意 : 这 只 是 一 个 说 明 其 语法 的 例子 。 对 于 传递 GIF 图 像 数 据 ， 并 没有 一 个 标准 的 数据 
风格 。 
如 果 没 有 给 定 任何 class 参数 ， 那 么 表示 类 就 是 InputStream, 
为 了 传递 本 地 的 、 序 列 化 的 和 远程 的 Java 对 象 ， 人 们 定义 了 如 下 三 个 MIME 类 型 : 
application/x-java-jvm-local-objectref 
application/x-java-serialized-object 
application/x-java-remote-object 
注意 ; x- 前 组 表示 这 是 一 个 试用 名 ， 并 不 是 IANA 批准 的 名 字 ，IANA 是 负责 分 配 标准 
的 MIME 类 型 名 的 机 构 。 
例如 ， 标 准 的 stringF1avor 数据 风格 是 由 下 面 这 个 MIME 类 型 描述 的 : 
application/x-java-serialized-object;class=java. lang. String 
可 以 让 剪贴 板 列 出 所 有 可 用 的 风格 : 
DataFlavor[] flavors = clipboard.getAvailableDataFlavors(); 
也 可 以 在 剪贴 板 上 安装 一 个 FlavorListener， 当 剪贴 板 上 的 数据 风格 集合 产生 变化 
时 ， 可 以 通知 风格 监听 器 。 细 节 请 参阅 API 注释 。 





è DataFlavor(String mimeType, String humanPresentab1eName ) 


创建 一 个 数据 风格 ， 它 描述 了 一 个 流 数据 ， 该 流 数 据 的 格式 是 由 一 个 MIME 28 AY r ti 


述 的 。 
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参数 ，mimeType 一 个 MIME 类 型 字符 串 
humanPresentableName 一 个 更 易于 阅读 的 名 字 版 本 
e DataFlavor(Class class, String humanPresentableName) 
创建 一 个 用 来 描述 Java 平 台 类 的 数据 风格 。 它 的 MIME 类 型 是 application/ 
x-—java—serialized-object;class=className, 
参数 ; class 从 Transferable 检索 到 的 类 
humanPresentableName 一 个 可 阅读 的 名 字 版 本 
e String getMimeType() 
返回 该 数据 风格 的 MIME 类 型 字符 串 。 
@ boolean isMimeTypeEqual(String mimeType) 
测试 该 数据 风格 是 否 有 给 定 的 MIME 类 型 。 
e String getHumanPresentableName() 
为 该 数据 风格 的 数据 格式 返回 人 们 容易 阅读 的 名 字 。 
eClass getRepresentationClass() 
返回 一 个 Class 对 象 ， 它 代表 用 该 数据 风格 调用 Transferable 时 返回 的 对 象 的 类 。 
它 可 以 是 MIME 类 型 的 class 参数 ， 也 可 以 是 InputStream, 





e DataFlavor[] getAvailableDataFlavors() 5.0 
返回 一 个 可 用 风格 的 数组 。 
e void Oe eee listener) 5.0 


添加 一 个 监听 器 ， 当 可 用 的 风格 发 生 改 变 时 ， 会 通知 该 监听 器 。 





e DataFlavor[] getTransferDataFlavors() 


返回 一 个 所 文 持 风格 的 数组 。 





evoid flavorsChanged(FlavorEvent event) 


当 一 个 剪贴 板 中 可 用 的 风格 集 发 生变 化 时 ， 就 调用 该 方法 。 


11.13.4 构建 一 个 可 传递 的 图 像 


想 要 通过 剪 贴 板 传递 对 象 就 必须 实现 Transferable 接口 。StringSelection 类 是 目前 
Java 标准 库 中 唯一 一 个 实现 了 Transferable 接口 的 公有 类 。 在 这 一 节 中 ， 我 们 将 介绍 如 何 
通过 剪贴 板 来 传递 图 像 。 因 为 Java 并 没有 提供 传递 图 像 的 类 ， 所 以 读者 必须 自己 去 实现 它 。 

这 个 类 其 实 只 是 一 个 非常 普通 的 类 。 它 直接 告知 其 唯一 可 用 的 数据 格式 是 DataF1avor. 
imageF1avor， 并 且 它 持 有 一 个 image 对 象 。 





ey ae aD ee YE EE SN PEE SPES NTE LST piid i i E EET EA A 
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class ImageTransferable implements Transferable 


{ 


private Image theImage; 


public ImageTransferable(Image image) 


{ 
theImage = image; 


} 


public DataFlavor[] getTransferDataFlavors() 
{ 


return new DataFlavor[] { DataFlavor.imageFlavor }; 


} 


public boolean isDataFlavorSupported(DataFlavor flavor) 


{ 


return flavor.equals(DataFlavor.imageFlavor); — 


} 


public Object getTransferData(DataFlavor flavor) 
throws UnsupportedFl avorException 


if(flavor.equals(DataFlavor. imageFlavor) ) 


return theImage; 


} 


else 


{ 


throw new UnsupportedFlavorException(flavor) ; 
} 
} 
} 
注意 : Java SE 提供 了 DataFlavor.imageFlavor 常量 ， 并 且 负 责 执 行 所 有 复杂 的 操作 ， 
以 便 进 行 Java 图 像 与 本 机 剪贴 板 图 像 的 转换 。 但 是 ， 奇 怪 的 是 ， 它 并 没有 提供 将 图 像 放 


入 剪贴 板 时 所 必需 的 包装 类 。 


DA, 


E sane 





图 11-41 将 图 像 从 一 个 Java 程序 拷贝 到 本 机 程序 中 
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程序 清单 11-18 中 的 程序 展示 了 如 何在 Java 应 用 程序 和 系统 剪贴 板 之 间 进 行 图 像 传递 。 
当 程序 开始 运行 时 ， 它 产生 了 一 个 包含 红 圈 的 图 像 。 点 击 Copy 按钮 把 图 像 拷贝 到 剪贴 板 上 ， 
然后 将 它 粘 贴 到 另 一 个 应 用 中 (参见 图 11-41 )。 之 后 再 从 另 一 个 应 用 拷贝 一 个 图 像 到 系统 前 
贴 板 中 ， 然 后 点 击 Paste 按钮 ， 就 可 以 看 到 该 图 像 被 粘贴 到 示例 程序 中 了 (参见 图 11-42 )。 





图 11-42 ”将 图 像 从 本 机 程序 拷贝 到 一 个 Java 程序 中 


该 程序 是 直接 在 文本 传递 程序 基础 上 进行 修改 而 得 到 的 。 现 在 的 数据 风格 是 DataF1avor. 


imageF1avor ， 并 且 我 们 使 用 的 是 ImageSelection 类 来 将 图 像 传 递 给 系统 前 贴 板 。 





o © ww mn A u N 一 
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package imageTransfer; 


import java.awt.*: 

import java.awt.datatransfer.*; 
import java.awt.image.*; 

import java.io.*; 


import javax.swing.*; 


/** 
* This frame has an image label and buttons for copying and pasting an image. 
ay 
class ImageTransferFrame extends JFrame 
{ 
private JLabel label; 
private Image image; 
private static final int IMAGE_WIDTH = 300; 
private static final int IMAGE HEIGHT = 300; 


public ImageTransferFrame() 


label = new JLabel(); 
image = new BufferedImage(IMAGE_WIDTH, IMAGE_HEIGHT, BufferedImage. TYPE_INT_ARGB) ; 
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Graphics g = image.getGraphics() ; 

g.setColor(Color.WHITE) ; 

g.fillRect(0, 0, IMAGE_WIDTH, IMAGE_HEIGHT) ; 

g.setColor(Color.RED) ; 

g,fi110val (IMAGE_WIDTH / 4, IMAGE WIDTH / 4, IMAGE_WIDTH / 2, IMAGE_HEIGHT / 2); 


label .setIcon(new ImageIcon(image)) ; 
add(new JScrol]Pane(label), BorderLayout.CENTER) ; 
JPanel panel = new JPanel (); 


JButton copyButton = new JButton("Copy") ; 
panel ,add(copyButton) ; 
copyButton.addActionListener(event -> copy()); 


]Button pasteButton = new ]Button( Paste ) ; 
panel .add(pasteButton) ; 
pasteButton.addActionListener(event -> paste()); 


add(panel, BorderLayout. SOUTH) ; 
pack() ; 


* Copies the current image to the system clipboard. 


private void copy() 


Clipboard clipboard = Toolkit.getDefaultTool kit () .getSystemCli pboard() ; 
ImageTransferable selection = new ImageTransferable (image) ; 
clipboard.setContents(selection, null); 


* Pastes the image from the system clipboard into the image label. 


private void paste() 


Clipboard clipboard = Toolkit.getDefaultToolkit() .getSystemC]i pboard() ; 
DataFlavor flavor = DataFlavor.imageFlavor; 
if (clipboard. isDataFlavorAvailable(flavor)) 

try 


image = (Image) clipboard. getData(flavor) ; 
label.setIcon(new ImageIcon(image)) ; 


catch (UnsupportedFlavorException | IOException ex) 


JOptionPane.showMessageDialog(this, ex); 
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11.13.5 通过 系统 剪贴 板 传递 Java WK 


假设 你 想 从 一 个 Java 应 用 拷贝 和 粘贴 对 象 到 另 一 个 Java 应 用 中 ， 此 时 ， 你 可 以 通过 在 
系统 剪贴 板 中 放置 序列 化 的 Java 对 象 来 实现 此 任务 。 

程序 清单 11-19 中 的 程序 展示 了 这 种 能 力 。 该 程序 显示 了 一 个 颜色 选择 器 ;Copy 按钮 将 
使 当前 的 颜色 以 序列 化 Color 对 象 的 方式 拷贝 到 系统 剪贴 板 上 ;Paste 按钮 可 以 用 来 检查 系统 
剪贴 板 中 是 否 包含 了 一 个 序列 化 的 Color 对 象 ， 如 果 包 含 的 话 ， 它 将 提取 该 颜色 ， 并 且 将 它 
设置 为 颜色 选择 器 的 当前 选择 。 

可 以 在 两 个 Java 应 用 程序 之 间 传 递 被 序列 化 的 对 象 (参见 图 11-43 )。 运 行 两 个 
SerialTransferTest 程序 ， 在 第 一 个 程序 上 点 击 Copy 按钮 ， 然 后 ， 在 第 二 个 程序 上 点 击 
Paste 按钮 。 这 时 ， 颜 色 对 象 便 会 从 一 个 虚拟 机 传递 到 另 一 个 虚拟 机 。 





图 11-43 ”数据 在 一 个 Java 应 用 的 两 个 实例 之 间 进 行 拷贝 


为 了 局 用 数据 传递 ，Java 平台 将 二 进 制 数据 放置 到 包含 了 被 序列 化 对 象 的 系统 剪贴 板 上 。 
这 样 ， 为 一 个 Java 程序 就 能 够 获取 剪贴 板 中 的 数据 ， 并 且 反 序列 化 该 对 象 ， 该 Java 程序 没 
有 必要 与 产生 剪贴 板 数据 的 程序 属于 相同 类 型 的 程序 。 

当然 ， 一 个 非 Java 的 应 用 将 不 知道 如 何 处 理 剪 贴 板 中 的 数据 。 出 于 这 个 原因 ， 该 示例 程 
序 提 供 了 采用 第 二 种 风格 的 剪贴 板 数据 ， 即 文本 数据 。 该 文本 是 对 被 传递 对 象 调用 toString 
方法 得 到 的 结果 。 如 果 要 查看 第 二 种 剪贴 板 的 数据 风格 ， 则 运行 该 程序 ， 点 击 一 种 颜色 ， 然 
后 在 你 的 文本 编辑 器 中 选中 Paste 命令 之 后 类 似 于 下 面 这 样 的 一 个 字符 串 : 

java.awt.Color[r=255,g=0,b=51] 
就 会 被 插 和 人 到 你 的 文档 中 。 

实际 上 并 不 需要 进行 额外 的 编程 就 可 以 传递 一 个 被 序列 化 的 对 象 ， 我 们 可 以 使 用 MIME 
类 型 : 

application/x-java-serialized-object;class=className 


与 表面 一 样 ， 你 必须 构建 自己 的 传递 包装 器 ， 细 节 请 参见 示例 代码 。 





RE ee ee ee ee N ee a ee ee P eee Pee To we ee 


Sy edb dk Ra ail oe ak: 
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package serialTransfer; 


import java.awt.*; 

import java.awt.datatransfer.*; 
import java.awt.event. *; 

import java.i0.*; 

import javax.swing.*; 


DO oo En woe A we N m 


/** 


10 * This frame contains a color chooser, and copy and paste buttons. 
* 


12 Class SerialTransferFrame extends JFrame 


[= 
H 


14 private JColorChooser chooser; 


16 public SerialTransferFrame() 


17 { 

18 chooser = new JColorChooser() ; 

19 add(chooser, BorderLayout.CENTER) ; 

20 JPanel panel = new JPanel (); 

21 

22 Button copyButton = new JButton("Copy") ; 

23 panel .add(copyButton) ; 

24 copyButton.addActionListener(event -> copy()); 

25 

26 JButton pasteButton = new JButton("Paste") ; 

27 panel .add(pasteButton) ; 

28 pasteButton.addActionListener(event -> paste()); 

29 

30 add(panel, BorderLayout. SOUTH) ; 

31 pack(); 

32 } 

33 

34 /** 

35 * Copies the chooser's color into the system clipboard. 
36 */ 

37 private void copy() 

38 { 

39 Clipboard clipboard = Toolkit.getDefaultToolkit() .getSystemClipboard() ; 
40 Color color = chooser.getColor() ; 

41 SerialTransferable selection = new SerialTransferable(color) ; 
42 clipboard.setContents (selection, null); 

43 } 

44 

45 /** 

46 * Pastes the color from the system clipboard into the chooser. 
47 */ 


48 private void paste() 


{ 
50 Clipboard clipboard = Toolkit.getDefaultToolkit() .getSystemC]ipboard() ; 
51 try 
52 { 


53 DataFlavor flavor = new DataFlavor( 
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"application/x-java-serialized-object;class=java.awt.Color"); 
if (clipboard.isDataFlavorAvailable(flavor)) 


Color color = (Color) clipboard. getData(flavor) ; 
chooser.setColor(color); 


} 


catch (ClassNotFoundException | UnsupportedFlavorException | IOException ex) 


{ 


} 
} 


JOptionPane.showMessageDialog(this, ex); 


/** 


* This class is a wrapper for the data transfer of serialized objects. 


class SerialTransferable implements Transferable 


private Serializable obj; 


/** 
* Constructs the selection. 
* @param o any serializable object 
gi 


SerialTransferable(Serializable 0) 


obj = 0; 


} 


public DataFlavor[] getTransferDataFlavors() 
{ 
DataFlavor[] flavors = new DataFlavor [2] ; 
Class<?> type = obj.getClass(); 
String mimeType = "“application/x-java-serialized-object;class=" + type.getName(); 
try 


flavors[0] = new DataFlavor(mimeType) ; 
flavors[1] = DataFlavor.stringFlavor; 
return flavors; 


catch (ClassNotFoundException e) 


{ 


} 
} 


return new DataFlavor[0]; 


public boolean isDataFlavorSupported(DataFlavor flavor) 


return DataFlavor.stringFlavor.equals(flavor) 
|| “application”. equals(flavor.getPrimaryType()) 
&& "Xx-java-serialized-object".equals(flavor.getSubType()) 
&& flavor. getRepresentationClass().isAssignabl eFrom(obj.getClass()); 
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108 
109 public Object getTransferData(DataFlavor flavor) throws UnsupportedFlavorException 
110 


111 if (!isDataFlavorSupported(flavor)) throw new UnsupportedFlavorException(flavor) ; 
112 

113 if (DataFlavor.stringFlavor.equals(flavor)) return obj.toStringQ ; 

114 

115 return obj; 


116 
117 } 


11.13.6 ”使 用 本 地 剪贴 板 来 传递 对 象 引用 


有 时 ， 你 需要 拷贝 和 粘贴 一 种 数据 类 型 ， 但 是 该 数据 类 型 并 不 是 系统 剪贴 板 所 支持 的 数 
据 类 型 ， 且 该 数据 类 型 是 不 可 序列 化 的 。 如 果 要 在 同一 个 虚拟 机 内 传递 一 个 任意 的 Java 对 象 
引用 ， 可 以 使 用 MIME 类 型 。 

application/x-java-jvm-local-objectref;class=className 

这 时 需要 为 这 种 类 型 定义 一 个 Transferable 包装 器 ， 其 过 程 与 前 面 示例 中 介绍 的 
SerialTransferable 包装 器 完全 相似 。 

对 象 的 引用 只 有 在 单个 虚拟 机 中 才 有 意义 。 出 于 这 个 原因 ， 不 能 将 形状 对 象 拷贝 到 系统 
剪贴 板 中 。 相 反 ， 要 使 用 本 地 剪贴 板 : 

Clipboard clipboard = new Clipboard("local"); 

构造 器 的 参数 是 剪贴 板 的 名 字 。 

不 过 ， 使 用 本 地 剪贴 板 有 一 个 重要 的 缺点 : 你 必须 使 本 地 剪贴 板 和 系统 和 剪贴 板 同 步 ， 这 
样 用 户 才 不 会 将 两 者 混淆 。 目 前 ，Java 平台 并 没有 执行 这 个 同步 的 功能 。 


YA y 
‘i 





e Clipboard(String name) 
构建 一 个 带 有 指定 名 字 的 本 地 剪贴 板 。 


11.14 ” 拖 放 操作 


使 用 剪 切 和 粘贴 操作 在 两 个 程序 之 间 传 递 信息 时 ， 前 贴 板 起 到 了 一 个 中 介 的 作用 。 拖 放 
操作 ， 打 个 比方 来 说 就 是 去 掉 中 间 人 ， 让 两 个 程序 之 间 直 接 通 信 。Java 平台 为 拖 放 操作 提供 
了 基本 的 支持 。 我 们 还 可 以 在 Java 程序 和 本 地 程序 之 间 进 行 拖 放 操作 。 本 节 将 要 介绍 如 何 编 
写作 为 放置 目标 的 Java 应 用 ， 以 及 如 何 编写 作为 拖 电 源 的 应 用 。 

在 深入 介绍 Java 平台 的 拖 放 操作 支持 特性 之 前 ， 让 我 们 快速 地 浏览 一 些 拖 放 操 作 的 用 户 
界面 。 我 们 使 用 Windows Explorer 和 WordPad 程序 作为 示例 。 在 其 他 平台 上 ， 读 者 可 以 使 用 
本 机 可 用 的 带 有 拖 放 操 作 的 程序 来 做 试验 。 
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FY EE RAB SAS a PRE, hg BE FEE TAS POR , 
然后 将 选 定 的 目标 拖 离 它 的 初始 位 置 。 当 你 在 接收 放置 操作 的 放置 目标 上 释放 鼠标 按键 时 ， 
放置 目标 将 查询 拖 电 源 ， 进 而 了 解 关 于 放置 元 素 的 信息 ， 并 且 局 动 某 个 恰当 的 操作 。 例 如 ， 
如 果 将 一 个 文件 图 标 从 文件 管理 器 中 拖 放 到 某 个 目录 图 标的 上 面 ， 那 么 这 个 文件 就 会 被 移动 
到 这 个 目录 中 。 但 是 ， 如 果 将 它 拖 放 到 一 个 文本 编辑 器 中 ， 那 么 文本 编辑 硕 就 会 打开 这 个 文 
件 。( 当 然 ， 这 要 求 我 们 所 使 用 的 文件 管理 句 和 文本 编辑 器 支持 拖 放 操作 ， 例 如 Windows 中 
的 Explore 与 WordPad， 以 及 Gnome 中 的 Nautilus 与 gedit), 

GN SR AEF BS AY EN RFE CTRL 键 ， 那 么 放置 操作 的 类 型 将 从 移动 操作 变 为 拷贝 操作 ， 该 
文件 的 一 份 拷贝 被 放 和 人 此 目录 中 。 如 果 同 时 按 住 了 SHIFT 和 CTRL 键 ， 那 么 该 文件 的 一 个 链 
接 将 被 放 人 到 此 目录 中 。( 其 他 平台 可 能 使 用 别 的 按键 组 全 来 执行 这 些 操作 ) 

因此 ， 有 三 种 带 有 不 同 姿态 的 放置 操作 : 

o 移动 ; 

e ei; 

© 链接 。 

链接 操作 的 目的 是 建立 一 个 对 被 放置 元 素 的 引用 。 这 种 链接 通常 需要 得 到 本 机 操作 系统 
的 支持 〈 比 如 用 于 文件 的 符号 链接 ， 或 者 用 于 文档 构件 的 对 象 链接 )， 并 且 它 通常 在 路 平台 的 
程序 中 没有 太 大 的 意义 。 在 本 节 中 ， 我 们 将 着 重 介绍 如 何 使 用 拖 放 操作 来 进行 拷贝 和 移动 。 

拖 忠 操作 通常 能 够 产生 某 种 直观 的 反馈 信息 ， 至 少 光 标的 形状 会 发 生 改 变 。 当 你 把 光标 移 
动 到 可 能 的 放置 目标 上 时 ， 光 标的 形状 将 会 表示 出 放置 操作 是 否 可 行 。 如 果 放 置 操作 可 行 的 话 ， 
光标 的 形状 也 会 表示 出 放置 动作 的 类 型 。 表 11-6 显示 了 光标 在 放置 目标 上 所 显示 的 几 种 形状 。 


表 11-6 放置 光标 的 形状 


动作 Windows 图 标 Gnome 图 标 
移动 N N 
H F 
链接 全 E 
不 准 放置 © © 


除了 文件 图 标 外 ， 也 可 以 拖 忠 别 的 元 素 。 例 如 ， 可 以 在 WordPad 中 选择 文本 ， 然 后 拖 熏 
之 。 请 试 着 将 文本 字段 放 到 你 希望 放置 的 对 象 中 ， 并 且 观 察 它 们 做 何 反应 。 


注意 : 这 个 试验 显示 了 作为 用 户 界 面 机 制 的 拖 放 操 作 的 一 个 缺点 。 用 户 很 难 预计 究竟 能 拖 
彼 什 么 ， 可 以 将 它们 放置 到 何 处 ， 以 及 当 实 施 拖 放 操 作 时 会 出 现 什么 情况 。 由 于 默认 的 移 
动 操作 能 够 删除 原始 的 元 素 ， 因 此 用 户 在 使 用 想 放 操作 时 比较 谨慎 ， 这 是 可 以 理解 的 。 

11.14.1 Swing 对 数据 传递 的 支持 
从 Java SE 1.4 开始 ， 多 种 Swing 构件 就 已 经 内 置 了 对 数据 传递 的 支持 (参见 表 11-7 )。 
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我 们 可 以 从 大 量 的 构件 中 拖 忠 选中 的 文本 ， 也 可 以 将 文本 放置 到 文本 构件 中 。 为 了 向 后 兼容 
性 ， 我 们 必须 使 用 setDragEnabled 方法 来 激活 拖 忠 功能 ， 而 放置 功能 总 是 会 得 到 文 持 的 。 


表 11-7 Swing 中 支持 数据 传递 的 构件 


构 F K BS i 放置 目标 
JFileChooser 导出 文件 列表 无 
JColorChooser 导出 颜色 对 象 接收 颜色 对 象 
JTextField JFormattedTextField 导出 选 定 的 文本 接收 文本 
JPasswordFie1d 无 《由 于 安全 的 原因 ) 接收 文本 
JTextArea JTextPane JEditorPane 导出 选 定 的 文本 接收 文本 和 文件 列表 
JList JTable JTree 导出 所 选择 的 文本 描述 〈 只 复制 ) 无 


注意 : java.awt.dnd 包 提 供 了 一 个 低层 的 拖 放 API， 它 形成 了 Swing 拖 放 的 基础 。 我 
们 在 本 书 中 不 讨论 这 个 API。 


程序 清单 11-20 中 的 程序 演示 了 这 种 行为 。 在 运行 该 程序 时 ， 应 该 注意 下 面 几 点 : 

o 你 可 以 选择 列表 、 表 格 或 树 中 的 多 个 项 ( 见 程序 清单 11-21 )， 并 拖 电 它们 。 

o 从 表格 中 拖 忠 项 有 些 尴 软 ， 你 需要 先 用 鼠标 选择 ， 然 后 移 走 鼠标 ， 之 后 再 次 点 击 它 ， 
这 之 后 才能 拖 电 它 。 

o 当 你 在 文本 域 中 放置 项 时 ， 可 以 看 到 被 
拖 电 的 信息 是 如 何 被 格式 化 的 : 表格 中 
的 表 元 由 制 表 符 隔 开 ， 而 每 个 选中 的 
行 都 占据 单独 的 一 行 (参见 图 11-44 )。 

o 你 只 能 拷贝 而 不 能 移动 列表 、 表 格 、 
树 、 文 件 选择 器 或 颜色 选择 器 中 的 
项 。 对 于 所 有 的 数据 模型 来 说 ， 从 
列表 、 表 格 或 树 中 移 除 项 都 是 不 可 能 
的 。 在 下 一 节 中 你 将 会 看 到 当 数 据 模 
型 可 编辑 时 ， 可 以 如 何 实现 这 种 移 除 
能 力 。 让 

o 你 不 能 在 列表 、 表 格 、 树 或 文件 选择 | 


x 


mopem here _ _ een a eee : 
LEZEN, gia — 





以 将 颜色 从 一 个 颜色 选择 器 中 拖 电 到 AA Swing AARRE 
Fy ys 中 o 


e 你 不 能 将 文本 从 文本 域 中 拖 出 ， 因 为 我 们 没有 在 文本 域 上 调用 setDragEnabled, 
Swing 包 提供 了 一 个 潜在 的 非常 有 用 的 机 制 ， 可 以 迅速 地 将 一 个 构件 转换 成 一 个 拖 鼻 源 和 
放置 目标 。 我 们 可 以 为 给 定 的 属性 安装 一 个 传递 处 理 器 ， 例 如 ， 在 示例 程序 中 ， 我 们 调用 了 : 
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textField.setTransferHandler(new TransferHandler("background")) ; 


现在 ,将 以 将 颜色 拖 忠 到 文本 框 中 ， 而 其 背景 色 也 会 随 之 改变 。 

当 发 生 了 一 个 放置 操作 时 ,传递 处 理 器 将 检查 是 否 有 一 种 数据 风格 的 表示 类 为 Color， 
如 果 确 实 如 此 ， 那 么 它 便 调用 setBackground 方法 。 

通过 把 传递 处 理 器 安装 在 文本 区 域 中 ， 就 可 以 禁用 标准 的 传递 处 理 器 。 你 再 也 不 能 在 此 
文本 域 中 进行 剪 切 、 拷 贝 、 粘 贴 、 拖 电 或 者 放置 操作 了 。 但 是 ， 你 现在 可 以 把 颜色 从 该 文本 
域 中 拖 出 来 了 。 你 仍旧 需要 选中 文本 以 激活 拖 忠 姿态 。 当 拖 上 忠文 本 时 ， 你 会 发 现 你 可 以 将 其 
放置 到 颜色 选择 器 中 ， 并 将 其 颜色 值 改 变 成 文本 域 的 背景 色 。 但 是 ， 你 不 能 在 文本 域 中 放置 
文本 。 


1 package dnd; 
2 


ES ee see ee eh A = 


CA ht eee T 





3 import java.awt.*; 
4 import javax.swing.*; 





' /** 

7 * This program demonstrates the basic Swing support for drag and drop. 
8 * @version 1.11 2016-05-10 

9 * @author Cay Horstmann 

1 */ 

u public class SwingDnDTest 


3 public static void main(String[] args) 


15 EventQueue.invokeLater(() -> 

16 

17 JFrame frame = new SwingDnDFrame() ; 

18 frame.setTitle("SwingDnDTest") ; 

19 frame. setDefaul tCloseOperation(JFrame.EXIT_ON_CLOSE) ; 
20 frame. setVisible(true) ; 

21 }); 

22 } 

23 } 


package dnd; 
import java.awt.*; 


import javax.swing.*; 
import javax.swing.tree.*; 


iD oo ~ cm cm 和 wp rm er 


public class SampleComponents 


10 public static JTree tree() 
11 
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12 DefaultMutableTreeNode root = new DefaultMutableTreeNode("World") ; 
13 DefaultMutableTreeNode country = new DefaultMutableTreeNode("USA") ; 
14 root.add(country) ; 

15 DefaultMutableTreeNode state = new DefaultMutableTreeNode("California’) ; 
16 country.add(state) ; 

17 DefaultMutableTreeNode city = new DefaultMutableTreeNode("San Jose"); 
18 state.add(city); 

19 city = new DefaultMutableTreeNode("Cupertino") ; 

20 state. add(city) ; 

21 state = new DefaultMutableTreeNode("Michigan") ; 

22 country.add(state) ; 

23 city = new DefaultMutableTreeNode("Ann Arbor"); 

24 state.add(city); 

25 country = new DefaultMutableTreeNode("Germany") ; 

26 root.add(country) ; 

27 state = new Defaul tMutableTreeNode("Schleswig-Hol stein’) ; 

28 country.add(state) ; 

29 city = new DefaultMutableTreeNode("Kiel"); 

30 State. add (city); 

31 return new JTree(root) ; 

32 } 

33 

34 public static JList<String> listQ) 

35 { 

36 String[] words = { "quick", "brown", "hungry", "wild", "silent", "huge", "private", 
37 "abstract", "static", "final" }; 

38 

39 DefaultListModel<String> model = new DefaultListModel<>() ; 

40 for (String word : words) 

41 mode] .addElement (word) ; 

42 return new JList<>(model); 

43 } 


a public static JTable table() 


{ 
47 Object[][] cells = { { "Mercury", 2440.0, 0, false, Color.YELLOW }, 


48 { "Venus", 6052.0, 0, false, Color. YELLOW }, 

49 { "Earth", 6378.0, 1, false, Color.BLUE }, { "Mars", 3397.0, 2, false, Color.RED }, 
50 { "Jupiter", 71492.0, 16, true, Color.ORANCE }, 

51 { "Saturn", 60268.0, 18, true, Color.ORANGE }, 

52 { "Uranus", 25559.0, 17, true, Color.BLUE }, 

53 { "Neptune", 24766.0, 8, true, Color.BLUE }, 

54 { "Pluto", 1137.0, 1, false, Color.BLACK } }; 

55 

56 String[] columnNames = { "Planet", "Radius", "Moons", "Gaseous", "Color" }; 

57 return new JTable(cells, columnNames) ; 





e void setTransferHandler(TransferHandler handler) 1.4 


设置 一 个 用 来 处 理 数据 传递 操作 〈 剪 切 、 拷 贝 、 粘 贴 、 拖 鼻 、 放 置 ) AY Pee bar. 
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è TransferHandler(String oreert ee 
构建 一 个 传递 处 理 器 ， 它 可 以 在 执行 数据 传递 操作 时 读 取 或 者 写 和 人 带 有 给 定名 称 的 
JavaBeans 构件 的 属性 。 










® void setDragEnabled(boolean b) 1.4 
使 将 数据 从 该 构件 中 拖 忠 出 去 的 操作 可 用 或 者 禁用 。 


11.14.2 HR 


在 前 一 节 中 ， 你 已 经 看 到 了 如 何 利用 Swing 中 基本 的 拖 放 支持 。 在 本 节 中 ， 我 们 将 向 你 
展示 如 何 将 任意 的 构件 配置 成 拖 电源 。 在 下 一 节 中 ， 我 们 将 讨论 放置 目标 ， 并 将 一 个 示例 构 
件 同 时 设置 为 图 像 的 拖 忠 源 和 放置 目标 。 

为 了 定制 Swing 构件 的 拖 放行 为 ， 必 
须 子 类 化 TransferHandler 类 。 首 先 ， 
履 写 getSourceActions 方法 ， 以 表明 
该 构件 支持 什么 样 的 行为 (拷贝 、 移 动 、 
链接 )。 接 下 来 ， 窗 写 getTransferable 
方法 ， 以 产生 Transferable 对 象 ， 其 过 
程 体 循 向 剪贴 板 拷贝 对 象 的 过 程 。 

在 示例 程序 中 ， 我 们 从 一 个 JList 中 
拖 忠 图 像 ， 这 个 JList 填充 了 若干 图 像 的 图 
by (参见 图 11-45)。 下 面 是 createTrans 
ferable 方 法 的 实现 ， 被 选中 的 图 像 直 接 sa 
放置 到 一 个 ImageTransferable 包装 图 11-45 ImageList 的 拖 放 应 用 








be 
ET ad ini -< 








fit o 
protected Transferable createTransferable(JComponent source) 
{ 


JList list = (JList) source; 

int index = list.getSelectedIndex() ; 

if (index < 0) return null; 

ImageIcon icon = (ImageIcon) list.getModel () .getE]ementAt (index) ; 
return new ImageTransferable(icon.getImage()) ; 





211% 遍 级 AWT 731 


本 例 中 ， 我 们 庆幸 的 是 JList 已 经 具备 了 启动 拖 中 姿态 的 机 制 ， 你 只 需 通 过 调用 
setDragEnabled 方法 来 激活 这 种 机 制 。 如 果 你 希望 向 不 识别 拖 忠 姿态 的 构件 中 添加 对 拖 忠 
操作 的 支持 ， 则 需要 由 你 自己 来 启动 这 种 传递 。 例 如 ， 下 面 的 代码 展示 了 如 何在 JLabe1 上 
启动 拖 电 : 


label .addMouseLi stener(new MouseAdapter () 


public void mousePressed(MouseEvent evt) 


{ 
int mode; 
if ((evt.getModifiers() & (InputEvent.CTRL_MASK | InputEvent.SHIFT_MASK)) != 0) 

mode = TransferHandler.COPY; 

else mode = TransferHandler.MOVE; 
Component comp = (JComponent) evt.getSource() ; 
TransferHandler th = comp.getTransferHandler () ; 
th.exportAsDrag(comp, evt, mode) ; 

} 

D; 


这 里 ， 我 们 只 是 在 用 户 在 标签 上 点 击 时 启动 传递 。 更 复杂 的 实现 还 可 以 观察 引起 鼠标 微 
量 拖 忠 的 鼠标 移动 。 

当 用 户 完 成 放置 行为 后 ， 拖 电源 传递 处 理 器 的 exportDone 方法 就 会 被 调用 ， 在 这 个 方 
法 中 ， 如 果 用 户 执行 了 移动 动作 ， 则 应 该 移 除 被 传递 的 对 象 。 下 面 是 图 像 列表 的 相关 实现 : 


protected void exportDone(JComponent source, Transferable data, int action) 


{ 
if (action == MOVE) 


{ 
JList list = (JList) source; 
int index = list.getSelectedIndex() ; 
if (index < 0) return; 
DefaultListModel model = (DefaultListModel) list.getModel (); 
model. remove(index) ; 

} 

} 


MEP, OW TH ER, SMe TPA Ae ae: 
o 可 以 支持 哪些 行为 。 

o 可 以 传输 哪些 数据 。 

e 在 执行 移动 动作 之 后 ， 如 何 移 除 原 来 的 数据 。 

此 外 ， 如 果 拖 卡 源 是 表 11-7 中 所 列 构件 之 外 的 构件 ， 则 还 需要 观察 鼠标 姿态 和 局 动 传递 。 


ra pe oF 
F, CEP en ie a cite Rena 
ys) Sa ee peter CE TE AO 





e int getSourceActions(JComponent c) 
覆 写 该 方法 ， 让 其 返回 在 给 定 的 构件 上 进行 拖 中 时 ， 人 允许 对 拖 忠 源 执行 的 动作 (COPY, 
MOVE 和 LINK 的 位 组 合 )。 

e protected Transferable createTransferable(JComponent source) 
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覆 写 该 方法 ， 让 其 为 被 拖 忠 的 数据 创建 一 个 Transferable。 
e void exportAsDrag(JComponent comp, InputEvent e, int action) 
从 给 定 的 构件 中 启动 一 个 拖 电 姿态 ，action 参数 的 值 是 COPY、MOVE 或 LINK, 
eprotected void exportDone(JComponent source, Transferable data, 
int action) 


覆 写 该 方法 ， 让 其 在 传递 成 功 之 后 调整 拖 电源 。 
11.14.3 ”放置 目标 


在 本 节 中 ， 我 们 将 展示 如 何 实现 放置 目标 。 我 们 用 到 的 示例 还 是 填充 了 图 像 的 图 标的 
JList， 在 其 中 我 们 添加 了 对 放置 的 支持 ， 以 便 用 户 可 以 将 图 像 放置 到 列表 中 。 

要 使 一 个 构件 成 为 放置 目标 ， 需 要 设置 一 个 TransferHandler， 并 实现 canImport 和 
importData 方法 。 


注意 : 我 们 可 以 向 JFrame 中 添加 传递 处 理 器 。 其 最 常用 到 的 地 方 就 是 在 应 用 中 放置 文 
件 ， 有 效 的 放置 位 置 包 括 窗 体 的 装饰 和 菜单 条 ， 但 是 不 包括 窗 体 中 包含 的 构件 (它们 有 
自己 的 传递 处 理 器 )。 


当 用 户 在 放置 的 目标 构件 上 移动 鼠标 时 ，canImport 方法 会 被 连续 调用 ， 如 果 放 置 是 允 
许 的 ， 则 返回 true。 这 个 信息 会 对 光标 的 图 标 产 生 影响 ， 因 为 这 个 图 标 要 对 是 否 允 许 放 置 
给 出 可 视 的 反馈 。 

canImport 方法 有 了 一 个 TransferHandler.TransferSupport 类 型 的 参数 ， 通 过 
这 个 参数 ， 可 以 获取 用 户 选择 的 放置 动作 、 放 置 位 置 以 及 要 传输 的 数据 。( 在 Java SE6 之 前 ， 
调用 的 是 与 此 不 同 的 一 个 canImport 方法 ， 它 只 提供 数据 风格 的 列表 。) 

在 canImport 方法 中 ， 还 可 以 覆 写 用 户 的 放置 动作 。 例 如 ， 如 果 用 户 选择 了 移动 动作 ， 
但 是 移 除 原 有 项 是 不 恰当 的 ， 那 么 就 可 以 强制 传递 处 理 器 使 用 拷贝 动作 取而代之 。 

下 面 是 一 个 典型 的 示例 : 假设 图 像 列 表 构 件 将 接受 放置 文件 列表 和 图 像 的 请 求 ， 但 是 ， 
如 果 一 个 文件 列表 被 拖 忠 到 了 这 个 构件 中 ， 那 么 用 户 选 择 的 MOVE 动作 就 会 改 为 COPY 动作 ， 
这 样 图 像 文件 就 不 会 被 删除 。 


public boolean canImport(TransferSupport support) 
if (support.isDataFlavorSupported (DataFlavor. javaFileListFlavor)) 
{ 


if (support.getUserDropAction() == MOVE) support. setDropAction (COPY) ; 
return true; 


else return support.isDataFlavorSupported(DataFlavor. imageFlavor) ; 


更 复杂 的 实现 可 以 检查 拖 忠 的 文件 中 是 否 确 实 包含 图 像 。 
当 鼠 标 在 放置 目标 上 移动 时 ，Swing 构件 JList、JTable、JTree 和 JTextComponent 
会 给 出 有 关 插 入 位 置 的 可 视 反 馈 。 默 认 情 况 下 ， 选 中 (对 于 JList、JTable 和 JTree 而 言 ) 
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或 脱 字符 (对 于 JTextComponent MA) 被 用 来 表示 放置 位 置 。 这 种 方法 对 用 户 来 说 显得 很 
不 友好 ， 而 且 也 不 灵活 ， 它 被 设置 成 默认 值 只 是 为 了 向 后 兼容 。 应 该 调用 setDropMode Jy 
法 来 选择 更 恰当 的 可 视 反 馈 。 

可 以 控制 被 放置 的 数据 是 应 该 覆盖 已 有 项 ， 还 是 应 该 插入 到 已 有 项 的 中 间 。 例 如 ， 在 示 
例 程序 中 ， 我 们 调用 了 

SetDropMode(DropMode ,ON_OR_INSERT) ; 


以 允许 用 户 在 某 一 项 上 放置 (因此 也 就 覆盖 了 这 一 项 )， 或 者 在 两 项 之 间 插 入 (参见 图 146). 
表 11-8 给 出 了 Swing 构件 支持 的 放置 模式 。 





图 11-46 ”在 某 一 项 上 放置 的 可 视 指示 器 和 在 两 项 之 间 放 置 的 可 视 指示 全 


表 11-8 ”放置 模式 
构 件 支持 的 放置 模式 
JList, JTree ON, INSERT, ON_OR_INSERT, USE_SELECTION 
JTable ON, INSERT, ON_OR_INSERT, INSERT_ROWS, INSERT_COLS, ON_OR_INSERT_ROWS, 


ON_OR_INSERT_COLS, USE_SELECTION 
JTextComponent INSERT, USE SELECTION (实际 上 是 移动 脱 字 符 ， 而 不 是 选中 的 字符 ) 


一 日 用 户 结束 了 放置 姿态 ，importData 方法 就 会 被 调用 。 此 时 需要 从 拖 忠 源 获得 数据 ， 
在 TransferSupport 参数 上 调用 getTransferable 方法 就 可 以 获得 一 个 对 Transferable 
对 象 的 引用 。 这 与 拷贝 和 粘贴 时 使 用 的 接口 相同 。 

拖 放 最 常用 的 一 种 数据 类 型 是 DataFl1avor.javaFileListF1avor。 文 件 列表 摘 述 了 
要 放置 到 目标 上 的 文件 集合 ， 而 传递 数据 就 是 List<File> 类 型 的 一 个 对 象 。 下 面 的 代码 可 
以 获取 这 些 文件 : 

DataFlavor[] flavors = transferable.getTransferDataFl avors () ; 


if (Arrays.asList(flavors) .contains(DataFlavor. javaFileListFlavor) ) 


List<File> fileList = (List<File>) transferable. getTransferData(DataFlavor.javaFileListFlavor) ; 
for (File f : fileList) 


{ 
do something with f; 


} 
在 放置 表 11-8 中 列 出 的 构件 时 ， 需 要 知道 放置 数据 的 精确 位 置 。 在 TransferSupport 
参数 上 调用 getDropLocation 方 法 可 以 发 现 产 生 放 置 动 作 的 位 置 ， 这 个 方法 将 返回 一 
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个 TransferHandler.DropLocation fy # 4+ F % W Xt 2%. JList, JTable, JTree 和 
JTextComponent 类 都 定义 了 在 特定 的 数据 模型 中 指定 位 置 的 子 类 。 例 如 ， 在 列表 中 的 位 置 
可 以 是 一 个 整数 ， 但 是 树 中 的 位 置 就 必须 是 一 个 树 的 路 径 。 下 面 的 代码 展示 了 如 何在 我 们 的 
图 像 列表 中 获取 放置 位 置 . 

int index; 


if (support.isDrop()) 


JList.DropLocation location = (JList.DropLocation) support. getDropLocation() ; 
index = location.getIndex(); 


else index = model.size(); 


JList.DropLocation 子 类 有 一 个 getIindex 方 法 ， 该 方法 返回 放置 位 置 的 索引 。 
(JTree.DropLocation 子 类 有 一 个 类 似 的 getPath 方法 。) 

在 数据 通过 CTRL+V 组 合 键 粘贴 到 构件 中 时 ，importData 方法 也 会 被 调用 。 在 这 种 情 
iu F, getDropLocation 方法 将 抛 出 Il1legalStateException。 因 此 ， 如 果 isDrop 方 
法 返回 false， 我 们 就 只 是 将 粘贴 的 数据 追加 到 列表 的 尾部 。 

在 站 列表 、 表 格 或 树 中 插入 时 ， 还 需要 检查 数据 是 要 插入 到 项 之 间 ， 还 是 应 该 替换 插入 
位 置 的 项 。 对 于 列表 ， 可 以 调用 JList.DropLocation 的 isInsert 方 法， 对 于 其 他 的 构 
件 ， 请 查看 本 节 末 尾 关 于 它们 的 放置 位 置 类 的 API 说 明 。 

总 结 一 下 ， 为 了 使 一 个 构件 成 为 放置 目标 ， 需 要 添加 一 个 指定 了 下 列 内 容 的 传递 处 理 器 ; 

o 何 时 可 以 接受 被 拖 虹 的 项 。 

o 如 何 导 入 被 放置 的 数据 。 

此 外 ， 如 果 要 向 JList、JTable、JTree 和 JUTextCcomponent 添加 对 放置 的 支持 :还 
应 该 设置 放置 模式 。 

程序 清单 11-22 展示 了 完整 的 程序 。 注 意 ，ImageList 类 既是 拖 电源 ， 又 是 放置 目标 。 
请 尝试 在 两 个 列表 之 间 拖 上 忠 图 像 ， 也 可 以 从 其 他 程序 的 文件 选择 器 中 拖 忠 图 像 文件 到 这 些 列 
表 中 。 
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package dndImage; 


import java.awt.*; 

import java.awt.datatransfer.*; 
import java.i0.*; 

import java.nio.file.*: 

import java.util.*: 

import java.util.List; 

import javax.imageio.*; 

10 import javax.swing.*; 
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12 public class ImageListDnDFrame extends JFrame 


{ 
14 private static final int DEFAULT_WIDTH = 600; 
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private static final int DEFAULT_HEIGHT = 500; 


private ImageList listl; 
private ImageList list2; 


public ImageListDnDFrame() 


{ 
setSize(DEFAULT_WIDTH, DEFAULT_HEIGHT) ; 


list1 = new ImageList(Paths.get(getClass().getPackage().getName(), "images1")) ; 
list2 = new ImageList(Paths.get (getClass () .getPackage() . getName () , "jmages2")) ; 


setLayout(new GridLayout(2, 1)); 
add(new JScrol]Pane(list1)); 
add(new JScrol]Pane(list2)); 
} 
} 


class ImageList extends JList<Imagelcon> 
public ImageList(Path dir) 
{ 


DefaultListModel<ImageIcon> model = new DefaultListModel<>() ; 
try (DirectoryStream<Path> entries = Files.newDirectoryStream(dir)) 


for (Path entry : entries) 
model .addElement(new ImageIcon(entry.toString())); 
} 


catch (IOException ex) 


ex. printStackTrace() ; 


} 


setModel (model) ; 
setVisibleRowCount (0) ; 
setLayoutOrientation(JList.HORIZONTAL_WRAP) ; 
setDragEnabled(true) ; 
setDropMode (DropMode.ON_OR_INSERT) ; 
setTransferHandler(new ImageListTransferHandler()) ; 
} 
} 


class ImageListTransferHandler extends TransferHandler 
{ 

// support for drag 

public int getSourceActions(JComponent source) 


return COPY_OR_MOVE; 
} 


protected Transferable createTransferable(JComponent source) 


ImageList list = (ImageList) source; 





736 Java SRR AI ZRH 


int index = list.getSelectedIndex(); 

if (index < 0) return null; 

ImageIcon icon = list.getModel () .getE]ementAt (index) ; 
return new ImageTransferable(icon.getImage()) ; 


} 


protected void exportDone(JComponent source, Transferable data, int action) 
{ 
if (action == MOVE) 
{ 
ImageList list = (ImageList) source; 
int index = list.getSelectedIndex(); 
if (index < 0) return; 
DefaultListModel<?> model = (DefaultListModel<?>) list.getModel (); 
model . remove (index) ; 
} 
} 


// support for drop 
public boolean canImport(TransferSupport support) 


if (support.isDataFlavorSupported(DataFlavor. javaFileListFlavor)) 


{ 
if (support.getUserDropAction() == MOVE) support.setDropAction(COPY); 
return true; 


else return support. isDataFlavorSupported(DataFlavor. imageFlavor) ; 


} 


public boolean importData(TransferSupport support) 


{ 
ImageList list = (ImageList) support.getComponent() ; 


DefaultListModel<ImageIcon> model = (DefaultListModel<ImageIcon>) list.getModel (); 


Transferable transferable = support.getTransferable(); 


List<DataFlavor> flavors = Arrays.asList(transferable.getTransferDataFlavors()): 


List<Image> images = new ArrayList<>(); 
try 
if (flavors.contains (DataFlavor. javaFileListFlavor)) 


@SuppressWarnings ("unchecked") List<File> fileList 


= (List<File>) transferable.getTransferData(DataFlavor. javaFileListFlavor); 


for (File f : fileList) 
{ 
try 
images. add(ImageI0. read(f)) ; 


catch (IOException ex) 
{ 
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// couldn't read image--skip 
} 
} 


else if (flavors.contains(DataFlavor.imageFlavor)) 
images.add((Image) transferable.getTransferData(DataFlavor.imageFlavor)) ; 

int index; 

if (support. isDrop()) 

{ 
JList.DropLocation location = (JList.DropLocation) support.getDropLocation() ; 
index = location.getIndex() ; 


if (!location.isInsert()) model.remove(index); // replace location 


else index = model.size(); 
for (Image image : images) 


model .add(index, new ImageIcon(image)) ; 
index++; 


} 


return true; 


catch (IOException | UnsupportedFlavorException ex) 


return false; 





boolean canImport(TransferSupport support) 6 


覆 写 该 方法 ， 让 其 表示 目标 构件 是 否 能 够 接受 TransferSupport ZAU H RAIH R. 


boolean importData(TransferSupport support) 6 
覆 写 该 方法 ， 让 其 实现 由 TransferSupport 参数 描述 的 放置 或 粘贴 姿态 ， 并 且 在 了 导 
入 成 功 时 返回 true。 





void setTransferHandler(TransferHandler handler) 6 


将 传递 处 理 器 设置 成 为 只 处 理 放置 和 粘贴 操作 。 
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e void setDropMode(DropMode mode) 6 
将 这 个 构件 的 放置 模式 设置 成 为 表 11-8 中 指定 的 值 之 一 。 





e Component getComponent( ) 
获取 这 个 传递 的 目标 构件 。 
e DataFlavor[] getDataFlavors() 
获取 被 传递 数据 的 数据 风格 。 
e boolean isDrop() 
如 果 这 个 传递 是 放置 ， 则 返回 true， 如 果 是 粘贴 则 返回 false. 
e int getUserDropAction( ) 
获取 由 用 户 选 择 的 放置 动作 (MOVE, COPY 或 LINK), 
e getSourceDropActions() 
获取 拖 忠 源 允 许 执 行 的 放置 动作 。 
e getDropAction() 
e setDropAction() 
获取 和 设置 这 个 传递 的 放置 动作 。 最 初 ， 这 是 一 个 用 户 的 放置 动作 ， 但 是 它 可 以 被 传 
BAE SEAN T AA Ti o 
e DropLocation getDropLocation( ) 


获取 放置 的 鼠标 位 置 ， 如 果 该 传递 不 是 一 个 放置 动作 ， 则 抛 出 IT11ega1StateException。 





e Point getDropPoint() 
获取 在 目标 构件 中 放置 的 鼠标 位 置 。 





e boolean isInsert() 
如 果 数 据 被 插入 到 给 定位 置 之 前 ， 则 返回 true， 如 果 它 们 替换 了 已 有 数据 ， 则 返回 
false, 

e int getIndex() 

获取 模型 中 用 于 插入 或 替换 的 索引 。 





e boolean isInsertRow() 
e boolean isInsertColumn() 

如 果 输 入 被 插入 到 某 行 或 某 列 之 前 ， 则 返回 true, 
e int getRow() 
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e int getColumn( ) 


获取 模型 中 用 于 插 和 人 或 替换 的 行 或 列 索引 ， 如 果 放 置 发 生 在 空 区 域 ， 则 返回 -1。 





e TreePath getPath() 
e int getChildIndex() 
返回 树 的 路 径 和 孩子 ， 以 及 目标 构件 的 放置 模式 ， 该 模式 定义 了 拖 放 的 位 置 ， 如 下 表 


所 示 。 

放置 模式 树 编辑 动作 

INSERT 作为 该 路 径 的 一 个 孩子 插入 ， 插 和 人 到 获得 的 孩子 索引 之 前 
ON 或 USE_SELECTION ”替换 该 路 径 中 的 数据 〈 没 用 到 孩子 索引 ) 

INSERT_OR_ON 如 果 获 得 的 孩子 索引 为 -1， 则 以 ON 模式 执行 ， 否则， 以 





INSERT 模式 执行 


e int getIndex() 
插 和 人 数据 处 的 索引 。 


11.15 “平台 集成 


我 们 用 几 个 特性 来 结束 本 章 ， 这 些 特性 使 得 Java 应 用 看 起 来 更 像 是 本 地 应 用 。 闪 屏 特 性 
使 得 应 用 在 虚拟 机 启动 时 可 以 显示 一 个 闪 屏 ; java.awt.Desktop 类 使 我 们 可 以 启动 本 地 应 
用 ,例如 默认 的 浏览 器 和 E-mail 程序 最后， 可 以 像 许 多 本 地 应 用 一 样 ， 对 系统 托盘 进行 访 
问 ， 并 可 以 用 图 标 来 塞 满 它 。 


11.15.1 AB 


对 Java 应 用 最 常见 的 抱怨 就 是 启动 时 间 太 长 。 这 是 因为 Java 虚拟 机 花费 了 一 段 时间 去 
加 载 所 有 必需 的 类 ， 特 别 是 对 Swing 应 用 ， 它 们 需要 从 Swing 和 AWT 类 库 代 码 中 抽取 大 量 
的 内 容 。 用 户 并 不 喜欢 应 用 程序 花费 大 量 的 时 间 去 产生 初始 屏幕 ， 他 们 甚至 可 能 在 不 知道 首 
次 启动 是 否 成 功 的 情况 下 尝试 着 多 次 启动 该 应 用 程序 。 此 问题 的 解决 之 道 是 采用 内 屏 ， 即 逊 
速 出 现 的 小 窗 体 ， 它 可 以 告诉 用 户 该 应 用 程序 已 经 成 功 局 动 了 。 

当然 ， 我 们 可 以 在 main 方法 开始 之 后 立即 呈现 一 个 窗 体 ,但 是 ，main 方法 只 有 在 类 加 
载 器 加 载 了 所 有 需要 依赖 的 类 之 后 才 会 被 启动 ， 而 这 一 过 程 可 能 要 等 上 一 段 时间 。 

可 以 让 虚拟 机 在 启动 时 立即 显示 一 幅 图 像 来 解决 这 个 问题 。 有 两 种 机 制 可 以 指定 这 幅 图 
像 ， 一 种 是 使 用 命令 行 参 数 -sp1ash: 

java -splash:myimage.png MyApp 
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万 一 种 是 在 JAR 文件 的 清单 中 指定 : 


Main-Class: MyApp 
SplashScreen-Image: myimage.gif 


这 幅 图 像 会 立即 出 现 ， 并 会 在 第 一 个 AWT 窗 体 可 视 时 立即 自动 消失 。 我 们 可 以 使 用 任 
faf GIF, JPEG 或 PNG 图像、 动画 (GIF) 和 透明 (GIF 和 PNG) 都 可 以 得 到 支持 。 

如 果 你 的 应 用 程序 在 达到 main 之 后 立即 就 可 以 执行 ， 那 么 你 就 可 以 略 过 本 节余 下 的 
内 容 。 但 是 ， 许 多 应 用 使 用 了 插件 架构 ， 其 中 有 一 个 小 内 核 ， 它 将 在 启动 时 加 载 插件 集 。 
Eclipse 和 NetBeans 就 是 典型 的 实例 。 在 这 种 情况 下 ， 可 以 用 闪 屏 来 表示 加 载 进度 。 

有 两 种 方式 来 实现 上 述 功 能 ， 即 可 以 直接 在 闪 屏 上 绘制 ， 或 者 用 含有 相同 内 容 的 无 边界 
窗 体 来 蔡 换 初始 图 像 ， 然 后 在 该 窗 体 的 内 部 绘制 。 我 们 的 示例 程序 同时 展示 了 这 两 种 技术 。 

为 了 直接 在 闪 屏 上 绘制 ， 需 要 获取 一 个 对 闪 屏 的 引用 ， 以 及 它 的 图 形 上 下 文 与 尺寸 : 


SplashScreen splash = SplashScreen.getSplashScreen(); 
Graphics2D g2 = splash.createGraphics(); 
Rectangle bounds = splash.getBounds() ; 


现在 可 以 按照 常规 的 方式 来 绘制 了 。 当 绘制 完 
成 后 ， 调 用 update 来 确保 绘制 的 图 画 被 刷新 。 我 
们 的 示例 程序 绘制 了 一 个 简单 的 进度 条 ， 就 像 在 图 
11-47 中 左边 一 幅 图 中 看 到 的 那样 。 


g.fillRect(x, y, width * percent / 100, height); 
splash.update() ; 


注意 : 闪 屏 是 单 例 对 象 ， 因 此 你 不 能 创建 自己 
的 内 屏 对 象 。 如 果 在 命令 行 或 清单 中 没有 设 
置 任何 闪 屏 ，getSplashScreen 方 法 将 返回 


null, TECT 


HEEAR LAHAT, maman EA WARRENA k A 
像素 位 置 会 显得 很 元 长 ， 而 且 进 度 指示 器 不 会 去 观察 本 地 进度 条 。 为 了 避免 这 些 问 题 ， 可 以 
在 main 方法 启动 后 立即 将 初始 闪 屏 用 具有 相同 尺寸 和 内 容 的 后 续 视 窗 替 换 。 这 个 视窗 可 以 
包含 任意 的 Swing 构件 。 

程序 清单 11-23 中 的 示例 程序 展示 了 这 种 技术 。 图 11-47 右边 的 那 幅 图 展示 了 一 个 无 边 
界 的 窗 体 ， 它 有 一 个 面板 ， 绘 制 了 闪 屏 并 包含 一 个 UProgressBar。 现 在 我 们 对 Swing API 
有 了 完整 的 访问 能 力 ， 可 以 很 轻松 地 添加 消息 字符 串 而 不 用 受 像 素 位 置 的 困扰 了 。 

请 注意 ， 我 们 不 需要 移 除 初 始 内 屏 ， 它 会 在 后 续 视 窗 可 视 之 后 被 自动 移 除 掉 。 
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ı package splashScreen; 
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import java.awt.*; 
import java.util.List; 
import javax.swing.*; 


[** 
* This program demonstrates the splash screen API. 
* @ersion 1.01 2016-05-10 

* @author Cay Horstmann 


* 


public class SplashScreenTest 


{ 


private static final int DEFAULT_WIDTH = 300; 
private static final int DEFAULT_HEIGHT = 300; 


private static SplashScreen splash; 


private static void drawOnSplash(int percent) 


{ 


} 


Rectangle bounds = splash.getBounds() ; 
Graphics2D g = splash.createGraphics() ; 

int height = 20; 

int x = 2; 

int y = bounds. height - height - 2; 

int width = bounds.width - 4; 

Color brightPurple = new Color(76, 36, 121); 
g.setColor(brightPurple) ; 

g.fillRect(x, y, width * percent / 100, height); 
splash. update() ; 


* This method draws on the splash screen. 


*/ 


private static void initl() 


{ 


splash = SplashScreen.getSplashScreen() ; 
if (splash == null) 
{ 


IŽ BA AWT 


System.err.println("Did you specify a splash image with -splash or in the manifest?"); 


System. exit(1) ; 


} 
try 
{ 
for (int i = 0; i <= 100; i++) 
drawOnSplash(i); 
Thread.sleep(100); // simulate startup work 
} 
catch (InterruptedException e) 
{ 
} 
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58 
59 * This method displays a frame with the same image as the splash screen. 
60 */ 

61 private static void init2() 

62 { 

63 final Image img = new ImageIcon(splash.getImageURL()) .getImage() ; 
64 

65 final JFrame splashFrame = new JFrame(); 

66 splashFrame. setUndecorated(true) ; 

67 

68 final JPanel splashPanel = new JPanel () 

69 

70 public void paintComponent (Graphics g) 

71 { 

n g.drawImage(img, 0, 0, null); 

73 } 

1 }; 

75 

76 final JProgressBar progressBar = new JProgressBar(); 
77 progressBar. setStringPainted(true) ; 

78 splashPanel.setLayout (new BorderLayout()); 

79 splashPanel.add(progressBar, BorderLayout. SOUTH) ; 

80 

81 splashFrame.add(splashPanel) ; 

82 splashFrame. setBounds(splash.getBounds()) ; 

83 splashFrame.setVisible(true) ; 

84 

85 new SwingWorker<Void, Integer>() 

86 

87 protected Void doInBackground() throws Exception 
88 { 

89 try 

90 

91 for (int i = 0; i <= 100; i++) 

92 { 

93 publish(i); 

94 Thread. s]eep(100) ; 

95 } 

96 

97 catch (InterruptedException e) 

98 { 

99 } 

100 return null; 

101 } 

102 

103 protected void process(List<Integer> chunks) 

104 { 

105 for (Integer chunk : chunks) 

106 

107 progressBar.setString("Loading module " + chunk); 
108 progressBar. SetValue (chunk) ; 

109 splashPanel.repaint(); // because img is loaded asynchronously 
110 } 


111 } 
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113 protected void done() 

114 

115 splashFrame. setVisible(false) ; 

116 

117 JFrame frame = new JFrame(); 

118 frame. setSize(DEFAULT_WIDTH, DEFAULT_HEIGHT) ; 
119 frame. setDefaul tCloseOperation(JFrame.EXIT_ON_CLOSE) ; 
120 frame. setTitle("SplashScreenTest") ; 

121 frame.setVisible(true) ; 

122 } 

123 }.execute() ; 


126 public static void main(String args[]) 


128 initlQ; 

129 EventQueue.invokeLater(() -> init2()); 
30 } 

131 } 





e static SplashScreen getSplashScreen() 
获取 一 个 对 闪 屏 的 引用 ， 如 果 目 前 没有 任何 闪 屏 ， 则 返回 nu11。 
e URL getImageURL( ) 
evoid setImageURLCURL imageURL ) 
获取 或 设置 闪 屏 图 像 的 URL。 设 置 该 图 像 会 更 新 闪 屏 。 
e Rectangle getBounds() 
获取 闪 屏 的 边界 。 
eGraphics2D createGraphics() 
获取 用 于 在 闪 屏 上 绘制 的 图 形 上 下 文 。 
e void update() 
更 新 闪 屏 的 显示 。 
e void close() 


关闭 闪 屏 。 闪 屏 在 第 一 个 AWT 视窗 可 视 时 会 自动 关闭 。 


11.15.2 ”启动 桌面 应 用 程序 


java.awt.Desktop 类 使 我 们 可 以 启动 默认 的 浏览 器 和 E-mail 程序， 我 们 还 可 以 用 注 
册 为 用 于 某 类 文件 类 型 的 应 用 程序 来 打开 、 编 辑 和 打印 这 类 文件 。 

其 API 是 很 直观 的 。 首 先 ， 调 用 静态 的 isDesktopSupported 方法 ， 如 采 它 返回 true, 
则 当前 平台 支持 启动 桌面 应 用 程序 。 然 后 调用 静态 的 getDesktop 方法 来 获取 一 个 Desktop 
实例 。 
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并 非 所 有 桌面 环境 都 支持 所 有 的 API 操作 。 例 如 ， 在 Linux 上 的 Gnome 桌面 中 ， 有 可 
能 可 以 打开 文件 ， 但 是 不 能 打印 它们 。( 目 前 没有 对 文件 关联 中 的 “动词 ”进行 支持 。) BA 
明 平 台所 支持 的 操作 ， 可 以 调用 isSupported 方法 ， 并 将 Desktop .Action 枚 举 中 的 某 个 
值 传 给 它 。 我 们 的 示例 程序 中 包含 了 下 面 这 样 的 测试 : 


if (desktop.isSupported(Desktop.Action.PRINT)) printButton.setEnabled(true) ; 


为 了 打开 、 编 辑 和 打印 文件 ， 首 先 要 检查 这 个 动作 是 否 得 到 了 支持 ， 然 后 再 调用 open, 
edit Ml print 方法 。 为 了 启动 浏览 器 ， 需 要 传递 一 个 URI。( 有 关 URI 的 更 多 信息 可 参见 第 
4 章 。) 可 以 直接 用 包含 一 个 http 或 https 的 URL 的 字符 串 来 调用 URI 构造 器 。 

为 了 局 动 默 认 的 E-mail 程序 ， 需 要 构造 一 个 具有 特定 格式 的 URI， 即 ; 

mailto: recipient? query 

ix E recipient 是 接收 者 的 E-mail 地 址 ， 例 如 president@whitehouse.gov， 而 
query 包含 了 用 & 分 隔 的 name=value 对 ， 其 中 值 是 用 百 分 号 编码 的 。( 百 分 号 编码 机 
制 实质 与 第 4 章 所 描述 的 URL 编码 机 制 算法 相同 ， 但 是 空格 被 编码 为 %20， 而 不 是 +。) 
Subject=dinner%20RSVP&bcc= putin%40kremvax.ru 是 一 个 实例 ， 这 种 格式 归档 在 
RFC2368 中 (http://www.ietf.org/rfc/ rfc2368.txt)。 但 是 ，URI 类 不 了 解 有 关 mailto 这 类 URI 
的 任何 信息 ， 因 此 我 们 必须 组 装 和 编码 自己 的 URI。 

程序 清单 11-24 的 示例 程序 使 你 可 以 打开 、 编 辑 或 打印 你 选择 的 文件 ， 可 以 浏览 一 个 
URL, 或 者 启动 E-mail 程序 (参见 图 11-48 )。 
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图 11-48 ”启动 一 个 桌面 应 用 程序 





package desktopApp; 


import java.awt.*; 
import java.io.*; 
import java.net.*: 


CA Pe 
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import javax.swing.*; 


class DesktopAppFrame extends JFrame 


public DesktopAppFrame () 


{ 


setLayout(new GridBagLayout()) ; 

final JFileChooser chooser = new JFileChooser(); 
JButton fileChooserButton = new JButton("..."); 
final JTextField fileField = new JTextField(20); 
fileField.setEditable(false) ; 

JButton openButton = new JButton("Open") ; 
]Button editButton = new JButton("Edit"); 
]Button printButton = new JButton("Print"); 
final JTextField browseField = new JTextField(); 
JButton browseButton = new ]Button( “Browse ) ; 
final JTextField toField = new JTextField(); 
final JTextField subjectField = new JTextField(); 
]Button mailButton = new JButton("Mail”); 


openButton. setEnabl ed (false) ; 
edi tButton.setEnabled(false) ; 
printButton. setEnabl ed(false) ; 
browseButton.setEnabl ed (false) ; 
mai |Button. setEnabled(fal se) ; 


if (Desktop. isDesktopSupported() ) 
{ 


Desktop desktop = Desktop. getDesktop() ; 
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if (desktop,isSupported(Desktop.Action.OPEN)) openButton. setEnabled(true) ; 

if (desktop.isSupported(Desktop.Action.EDIT)) editButton.setEnabled(true) ; 

if (desktop. isSupported(Desktop.Action.PRINT)) printButton.setEnabled(true) ; 
if (desktop. isSupported(Desktop.Action.BROWSE)) browseButton.setEnabled(true) ; 
if (desktop.isSupported(Desktop.Action.MAIL)) mailButton.setEnabled(true) ; 


} 


fileChooserButton. addActionListener(event -> 


{ 


if (chooser. show0penDialog(DesktopAppFrame.this) == JFileChooser.APPROVE_OPTION) 
fileField.setText (chooser. getSelectedFile() .getAbsolutePath()) ; 


H; 


openButton.addActionListener(event -> 


{ 
try 


Desktop.getDesktop() .open(chooser.getSelectedFile()); 


catch (IOException ex) 


ex.printStackTrace() ; 
} 
让 
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edi tButton.addActionListener(event -> 
{ 
try 
{ 
Desktop. getDesktop() .edit (chooser. getSelectedFile()); 


catch (IOException ex) 


ex.printStackTrace() ; 
} 
)); 


printButton.addActionListener(event -> 


{ 
try 


Desktop. getDesktop() .print (chooser. getSelectedFile()); 
catch (IOException ex) 


ex.printStackTrace() ; 
} 
h); 


browseButton.addActionListener(event -> 


{ 
try 


{ 
Desktop.getDesktop() .browse(new URI (browseField.getText())); 


catch (URISyntaxException | IOException ex) 
{ 


ex. printStackTrace() ; 
} 
}); 


mailButton.addActionListener(event -> 
{ 
try 
{ 
String subject = percentEncode(subjectField.getText()); 
URI uri = new URI("mailto:" + toField.getText() + "?subject=" + subject); 


System.out.print]n(uri); 
Desktop.getDesktop() .mail (uri); 


catch (URISyntaxException | IOException ex) 


ex.printStackTrace() ; 
} 
D 


JPanel buttonPanel = new JPanel (); 
((FlowLayout) buttonPanel .getLayout()).setHgap(2); 
buttonPanel .add(openButton) ; 
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116 buttonPanel .add (edi tButton) ; 
117 buttonPanel .add(printButton) ; 


119 add(fileChooserButton, new GBC(0, 0) . setAnchor (GBC. EAST) .setInsets(2)) ; 

120 add(fileField, new GBC(1, 0).setFill (GBC.HORIZONTAL)) ; 

121 add(buttonPanel, new GBC(2, 0).setAnchor(GBC.WEST) .setInsets (0)); 

122 add(browseField, new GBC(1, 1).setFill (GBC.HORIZONTAL)) ; 

123 add(browseButton, new GBC(2, 1).setAnchor(GBC.WEST) .setInsets(2)) ; 

124 add(new JLabel("To:"), new GBC(0, 2).setAnchor(GBC.EAST).setInsets(5, 2, 5, 2)); 

125 add(toField, new GBC(1, 2).setFill (GBC.HORIZONTAL)) ; 

126 add(mailButton, new GBC(2, 2).setAnchor(GBC.WEST) .setInsets(2)) ; 

127 add(new JLabel("Subject:"), new GBC(0, 3).setAnchor(GBC.EAST).setInsets(5, 2, 5, 2)); 
128 add(subjectField, new GBC(1, 3).setFill (GBC.HORIZONTAL)) ; 


130 pack(); 
31 } 


133 private static String percentEncode(String s) 
134 { 
135 try 


{ 
137 return URLEncoder.encode(s, "UTF-8").replaceAl]("[+]", "%20"); 


139 catch (UnsupportedEncodingException ex) 

140 { 

141 return null; // UTF-8 is always supported 
142 } 

TEA 

144 } 






e static boolean isDesktopSupported( ) 
如 果 该 平台 支持 启动 桌面 应 用 程序 ， 则 返回 true, 

e static Desktop getDesktop() 
返回 用 于 启动 桌面 应 用 程序 的 Desktop 对 象 。 如 果 该 平台 不 支持 启动 桌面 操作 ， 则 抛 
出 UnsupportedOperationException 异常 。 

e boolean isSupported(Desktop.Action action) 
如 果 支 持 给 定 的 动作 ， MA E] true, action Æ OPEN, EDIT, PRINT, BROWSE 或 
MAIL 之 一 。 

e void open(File file) 
启动 注册 为 浏览 给 定 文件 的 应 用 程序 。 

evoid edit(File file) 
启动 注册 为 编辑 给 定 文件 的 应 用 程序 。 

evoid print(File file) 
打印 给 定 文件 。 
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e void browse(URI uri) 
用 给 定 的 URI 启动 默认 浏览 器 。 
è void mail() 


e void mail(URI uri) 


局 动 默认 邮件 程序 。 第 二 个 版 本 可 以 用 来 填充 E-mail 消息 的 部 分 内 容 。 
11.15.3 ”系统 托盘 


许多 桌面 环境 都 有 一 个 区 域 用 于 放置 在 后 台 运 行 的 程序 的 图 标 ， 这 些 程序 偶尔 会 将 其 此 
事件 通知 给 用 户 。 在 Windows 中 ， 这 个 区 域 称 为 系统 托盘 ， 而 这 些 图 标 称 为 托盘 图 标 。Java 
API 采纳 了 相同 的 术语 命名 规则 。 有 一 个 这 种 程序 的 典型 实例 ， 那 就 是 检查 软件 更 新 的 监视 
镶 。。 如 采 有 新 的 更 新 ， 监 视 器 程序 可 以 改变 其 图 标的 外 观 ， 并 在 图 表 附近 显示 一 条 消息 。 

坦 日 地 讲 ， 系 统 托盘 有 些 被 滥用 ， 当 计算 机 用 户 发 现 又 添加 了 新 的 托盘 图 标 时 ， 通 常 都 
会 感到 不 痛快 。 我 们 的 系统 托盘 应 用 程序 示例 也 逃脱 不 了 这 条 规则 ， 这 个 程序 可 以 分 发 虚拟 
的 “ 签 饼 ”。 

java.awt.SystemTray 类 是 路 平台 的 通 向 系统 托盘 的 渠道 ， 与 前 面 讨论 过 的 Desktop 
失 相 类 似 ， 首 先 要 调用 静态 的 isSupported 方法 来 检查 本 地 Java 平台 是 否 支 持 系统 托盘 、 
如 采 支 持 ， 则 通过 调用 静态 的 getSystemTray 方法 来 获取 SystemTray 的 单 例 。 

SystemTray 类 最 重要 的 方法 是 add 方 法， 它 使 得 








我 们 可 以 添加 一 个 TrayIcon 实例 。 托 盘 图 标 有 三 个 主 2 
o 图 标的 图 像 。 
o 当 鼠 标 滑 过 图 标 时 显示 的 工具 提示 。 
e 当 用 户 用 鼠标 右键 点 击 图 标 时 显示 的 弹出 式 菜单 。 > 


弹出 式 菜单 是 AWT 类 库 中 的 PopupMenu 类 的 一 个 
实例 ， 表 示 本 地 的 弹出 式 菜单 ， 而 不 是 Swing 菜单 。 可 3 
以 在 其 中 添加 AWT 的 Menultem Xfi), matext Sour Fonun = = A 
都 有 一 个 动作 监听 器 ， 就 像 Swing 中 的 菜单 项 一 样 。 

最 后 ， 托 盘 图 标 可 以 向 用 户 显示 通知 信息 (参见 
图 11-49 )， 这 需要 调用 TrayIcon 类 的 displayMessage “站 11-49 从 托盘 图 标 中 发 出 的 通知 
方法 ， 并 指定 标题 、 消 息 和 消息 类 型 。 

trayIcon.displayMessage("Your Fortune", fortunes.get(index), TrayIcon.MessageType. INFO) ; 

程序 清单 11-25 展示 了 将 “ 签 饼 ”图 标 置 于 系统 托盘 中 的 应 用 程序 。 这 个 程序 将 读 取 一 
个 签 饼 文 件 (从 UNIX 的 fortune 程序 中 读 取 )， 其 中 每 个 签 都 包含 一 段 文本 ， 这 段 文本 的 最 
后 一 行 包含 一 个 % 字符 。 这 个 程序 每 秒 显示 一 条 消息 。 幸 运 的 是 ， 有 一 个 弹出 菜单 可 以 用 来 
退出 该 应 用 程序 。 如 果 所 有 的 系统 托盘 图 标 都 这 么 贴心 就 好 了 ! 


A | 
— | 


ey ht was all so different before everything changed. 
J 
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package systemTray; 


import java.awt.*; 
import java.i0.*; 
import java.util.*; 
import java.util.List; 


import javax.swing.*; 
import javax.swing.Timer; 


/** 
* This program demonstrates the system tray API. 
* @ersion 1.02 2016-05-10 
* @author Cay Horstmann 
J 
public class SystemTrayTest 
{ 


public static void main(String[] args) 


{ 
SystemTrayApp app = new SystemTrayApp() ; 


app.initQ); 
} 


class SystemTrayApp 


{ 
public void init() 


final TrayICon trayIcon; 
if (!SystemTray.isSupported()) 
{ 


System.err.printin("System tray is not supported. ") ; 
return; 


} 


SystemTray tray = SystemTray.getSystemTray() ; 
Image image = new ImageIcon(getClass() .getResource("cookie. png")).getImageC) ; 


PopupMenu popup = new PopupMenu(); 

MenuItem exitItem = new Menultem("Exit"); 
exitItem.addActionListener(event -> System.exit(0)); 
popup.add(exitItem) ; 


trayIcon = new TrayIcon(image, "Your Fortune", popup); 


trayIcon. setImageAutoSi ze(true) ; 
trayIcon.addActionListener(event -> 


trayIcon.displayMessage("How do I turn this off?", 
"Right-click on the fortune cookie and select Exit.", 
TrayIcon.MessageType. INFO) ; 


Hi 
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55 try 

56 { 

57 tray.add(trayIcon) ; 

58 } 

59 catch (AWTException e) 

60 { 

61 System.err.printin("TrayIcon could not be added."); 

62 return; 

63 } 

64 

65 final List<String> fortunes = readFortunes(); 

66 Timer timer = new Timer(10000, event -> 

67 { 

68 int index = (int) (fortunes.size() * Math. random()); 
69 trayIcon.displayMessage("Your Fortune", fortunes.get(index) , 
70 TrayIcon.MessageType. INFO) ; 

71 Hy 

n timer.start(); 

73 } 


75 private List<String> readFortunes() 


17 List<String> fortunes = new ArrayList<>(); 

78 try (InputStream inStream = getClass() .getResourceAsStream("fortunes")) 
79 

80 Scanner in = new Scanner(inStream, "UTF-8"); 
81 StringBuilder fortune = new StringBuilder(); 
82 while (in. hasNextLine()) 

83 

84 String line = in.nextLine(); 

85 if (line.equals("%")) 

86 { 

87 fortunes. add(fortune. toString()); 

88 fortune = new StringBuilder(); 

89 } 

90 else 

91 { 

92 fortune. append(1ine) ; 

93 fortune.append(' '); 

94 

95 } 

96 } 

97 catch (IOException ex) 

98 

99 ex.printStackTrace() ; 

100 } | 

101 return fortunes; 

102 } 

103 } 





e static boolean isSupported() 





#11 Ž BRAWT 751 


如 果 这 个 平台 支持 对 系统 托盘 的 访问 ， 则 返回 true. 
e static SystemTray getSystemTray( ) 
返回 用 于 访问 系统 托盘 的 SystemTray 对 象 。 如 果 这 个 平台 不 支持 对 系统 托盘 的 访问 ， 
则 抛 出 UnsupportedOperationException 异常 。 
e Dimension getTrayIconSize() 
获取 系统 托盘 中 的 图 标的 尺寸 。 
e void add(TrayIcon trayIcon) 
e void remove(TrayIcon trayIcon) 


添加 或 移 除 一 个 系统 托盘 图 标 。 





e TrayIcon(Image image) 

e TrayIcon(Image image, String tooltip) 

ə TrayIcon(Image image, String tooltip, PopupMenu popupMenu ) 
用 给 定 的 图 像 、 工 具 提示 和 弹出 式 菜 单 构建 一 个 托盘 图 标 。 

e Image getImage( ) 

e void setImage(Image image) 

e String getTooltip() 

e void setTooltip(String tooltip) 

e PopupMenu getPopupMenu( ) 

e void setPopupMenu(PopupMenu popupMenu ) 
获取 或 设置 图 像 、 工 具 提 示 ， 或 该 工具 提示 的 弹出 式 菜单 

e boolean isImageAutoSize() 

e void setImageAutoSize(boolean autosize) 
获取 或 设置 imageAutoSize 属性 ， 如 果 设 置 了 ， 那么 图 像 就 会 缩放 到 适合 工具 提示 图 
标 区 的 大 小 。 如 果 没 有 设置 (默认 值 )， 那 么 图 像 就 会 被 截 除 (如果 图 像 太 大 )， 或 者 拓 
中 (如 果 图 像 太 小 )。 

evoid displayMessage(String caption, String text, Trayicon. 
MessageType messagelType) 
在 托盘 图 标 附近 显示 消息 。 消 息 的 类 型 为 INFO、WARNING ERROR 或 NONE 

epublic void addActionListener (ActionListener listener ) 

e public void removeActionListener(ActionListener listener) 
如 果 被 调用 的 监听 器 是 平台 依赖 的 ， 则 添加 和 移 除 动作 监听 器 。 典 型 情况 是 在 通知 信 
息 上 点 击 或 在 托盘 图 标 上 双击 。 

现在 ， 我 们 来 到 了 本 章 的 尾声 ， 这 长 长 的 一 章 涵盖 了 高 级 AWT 特性 。 在 最 后 一 章 ， 我 

们 将 转 而 研究 Java 编程 的 另 一 个 完全 不 同 的 方面 ; 在 同一 台 机 器 上 与 用 其 他 编程 语言 编写 的 
“本 地 ”代码 交互 。 





$125 本 地 方法 


A 从 Java 程序 中 调用 C 函数 A 调用 Java 方法 

A 数值 参数 与 返回 值 A 访问 数组 元 素 

A 字符 串 参 数 A 错误 处 理 

A 访问 域 A 使 用 调用 API 

A 编码 签名 A 完整 的 示例 : 访问 Windows 注册 表 


原则 上 说 ,“100% 纯 Java” 的 解决 方案 是 非常 好 的 ， 但 有 时 你 也 会 想 要 编写 或 使 用 其 他 
语言 的 代码 (这 种 代码 通常 称 为 本 地 代码 )。 

特别 是 在 Java 的 早期 阶段 ， 许 多 人 都 认为 使 用 C 或 C++ 来 加 速 Java 应 用 中 关键 部 分 是 
个 好 主意 。 但 是 ， 实 际 上 ， 这 基本 上 是 徒劳 的 。199%6 年 JavaOne 会 议 上 有 一 个 演讲 很 明确 地 
说 明了 这 一 点 ,来自 Sun Microsystems 的 密码 库 的 实现 者 报告 说 他 们 的 加 密 函 数 的 纯 Java 平 
台 实 现 已 至 化 境 。 他 们 的 代码 确实 没有 已 有 的 C 实现 快 ， 但 是 事实 证 明 这 无 关 紧 要 。Java 平 
台 实 现 比 网 络 IO 要 快 得 多 ， 而 后 者 是 真正 的 瓶颈 。 

当然 ， 求 助 于 本 地 代码 是 有 缺陷 的 。 如 果 应 用 的 某 个 部 分 是 用 其 他 语言 编写 的 ， 那 么 就 必须 
为 需要 文 持 的 每 个 平台 都 提供 一 个 单独 的 本 地 类 库 。 用 C 或 C++ 编写 的 代码 没有 对 通过 使 用 无 
效 指针 所 造成 的 内 存 覆 写 提 供 任 何 保护 。 编 写本 地 代码 很 容易 破坏 你 的 程序 ， 并 感染 操作 系统 。 

因此 ， 我 们 建议 只 有 在 必需 的 时 候 才 使 用 本 地 代码 。 特 别 是 在 以 下 三 种 情况 下 ， 也 许可 
以 使 用 本 地 代码 : 

e 你 的 应 用 需要 访问 的 系统 特性 和 设备 通过 Java 平台 是 无 法 实现 的 。 

e 你 已 经 有 了 大 量 的 测试 过 和 调试 过 的 用 另 一 种 语言 编写 的 代码 ， 并 且 知 道 如 何 将 其 导 

出 到 所 有 的 目标 平台 上 。 

e 通过 基准 测试 ， 你 发 现 所 编写 的 Java 代码 比 用 其 他 语言 编写 的 等 价 代码 要 慢 得 多 。 

Java 平台 有 一 个 用 于 和 本 地 C 代码 进行 互 操作 的 API， 称 为 Java 本 地 接口 (JNI)。 我 们 
将 在 本 章 讨论 INI 编程 。 


@ C++ FB: 你 可 以 使 用 C++ 代替 C 来 编写 本 地 方法 。 这 样 会 有 一 些 好 处 : 类 型 检查 会 更 
严格 一 些 ,访问 INI 函数 会 更 便捷 一 些 。 然 而 ，JNI 并 不 支持 Java 类 和 C++ 类 之 间 的 任 
何 映射 机 制 。 


12.1 从 Java 程序 中 调用 C 函数 


假设 你 有 一 个 C 函数 ， 它 能 为 你 实现 某 个 功能 ， 因 为 某 种 原因 ， 你 不 想 费 事 使 用 Java 编 
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程 语言 重新 实现 它 。 为 了 方便 说 明 问 题 ， 我 们 从 一 个 很 简单 的 打印 问候 语 的 C 函数 人手。 
Java 编程 语言 使 用 关键 字 native 表示 本 地 方法 ， 而 且 很 显然 ， 你 还 需要 在 类 中 放置 一 
个 方法 。 其 结果 显示 在 程序 清单 12-1 中 。 
关键 字 native 提醒 编译 器 该 方法 将 在 外 部 定义 。 当 然 ， 本 地 方法 不 包含 任何 Java 编程 
语言 编写 的 代码 ， 而 且 方 法 头 后 面 直接 跟着 一 个 表示 终结 的 分 号 。 因 此 ， 本 地 方法 声明 看 上 
去 和 抽象 方法 声明 类 似 。 


和 SIR AIN a hes A, Paras a 全 这 
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[xe 
* @version 1.11 2007-10-26 


* @author Cay Horstmann 
* 


class HelloNative 


public static native void greeting(); 


co ~“ oD a a w N e a i 


注意 : 与 前 一 章 一 样 ， 为 了 保持 样 例 的 简单 性 ， 我 们 在 这 里 也 不 使 用 包 。 


在 这 个 特定 示例 中 ， 本 地 方法 也 被 声明 为 static。 本 地 方法 既 可 以 是 静态 的 也 可 以 是 
非 静 态 的 ， 使 用 静态 方法 是 因为 我 们 此 刻 还 不 想 处 理 参数 传递 。 

你 实际 上 可 以 编译 这 个 类 ， 但 是 在 程序 中 使 用 它 时 ， 虚 拟 机 就 会 告诉 你 它 不 知道 如 何 找 
到 greeting， 它 会 报告 一 个 UnsatisfiedLinkError 异常 。 为 了 实现 本 地 人 代码， 需要 编 
写 一 个 相应 的 C 函数 ， 你 必须 完全 按照 Java 虚拟 机 预期 的 那样 来 命名 这 个 函数 。 其 规则 是 : 

1 ) 使 用 完整 的 Java 方 法 名 ， 比 如 :; He11oNative.greeting。 如 果 该 类 属于 某 个 包 ， 
那么 在 前 面 添 加 包 和 名 ， 比 如 : com.horstmann.HelloNative.greeting。 

2) 用 下 划 线 替换 掉 所 有 的 句号 ， 并 加 上 Java 前 级 ,例如 ，Java_HelloNative_greeting 
或 Java_com_horstmann_HelloNative_greeting。 

3) 如 果 类 名 含有 非 ASCH 字母 或 数字 ， 如 :''，'$' 或 是 大 于 '\u007F' 的 Unicode 字 
符 ， 用 _0xxxx 来 替代 它们 ，xxxx 是 该 字符 的 Unicode 值 的 4 个 十 六 进 制 数 序列 。 
注意 : 如 果 你 重 载 了 本 地 方法 ， 也 就 是 说 ， 你 用 相同 的 名 字 提 供 了 多 个 本 地 方法 ， 那 么 

你 必须 在 名 称 后 附加 两 个 下 划 线 ， 后面 再 加 上 已 编码 的 参数 类 型 。 在 本 章 后 面 ， 我 们 将 

描述 参数 类 型 的 编码 方法 。 例 如 ， 如 果 你 有 一 个 本 地 方法 greeting 和 另 一 个 本 地 方法 

greeting(int repeat), MA, #—+#K A uava_He11oNative_greeting__ ， 第 

二 个 称 为 Java_HelloNative_greeting__I, 


实际 上 ， 没 人 会 手工 完成 这 些 操 作 。 相 反 ， 你 应 该 运行 javah 实用 程序 ， 它 能 够 自动 生 
成 函数 名 。 要 使 用 javah， 首 先 要 编译 程序 清单 12-1 中 的 源 文件 。 


javac HelloNative.java 
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接着 ,调用 javah 实用 程序 ， 从 该 类 文件 中 产生 一 个 C 的 头 文件 。Javah 可 执行 文件 
可 以 在 jdk/bin 目录 下 找到 。 可 以 用 类 的 名 字 来 调用 它 ， 就 像 调用 Java 编译 器 一 样 。 例 如 ， 


javah HelloNative 


这 条 命令 会 产生 一 个 头 文件 HelloNative.h, 参见 程序 清单 12-2。 


o Ce N en wo A u N p 


10 





/* DO NOT EDIT THIS FILE - it is machine generated */ 
#include <jni.h> 
/* Header for class HelloNative */ 


#ifndef _Included_HelloNative 
#define _Included_HelloNative 
#ifdef _ cplusplus 
extern "C" { 
#endi f 
/* 

* Class: Hel loNative 

* Method: greeting 

* Signature: ()V 

$ 


JNIEXPORT void JNICALL Java_HelloNative_greeting 
(JNIEnv *, jclass); 


#ifdef _ cplusplus 


#endif 
#endi f 


如 你 所 见 ， 这 个 文件 包含 了 函数 Java HelloNative_greeting 的 声明 ( 宏 JNIEXPORT 和 
JNICALL 是 在 头 文件 jni .h 中 定义 的 ， 它 们 为 那些 来 自动 态 装 载 库 的 导出 函数 标明 了 依赖 


于 编译 需 的 说 明 符 )。 
现在 ， 需 要 将 函数 原型 从 头 文件 中 复制 到 源 文 件 中 ， 并 且 给 出 函数 的 实现 代码 ， 如 程序 


清单 12-3 所 示 。 


1 
2 
3 
4 
5 
6 
7 
8 
9 


10 
11 
12 


/* 
@version 1.10 1997-07-01 
@author Cay Horstmann 


i 


#include "HelloNative.h" 
#include <stdio.h> 


NIEXPORT void JNICALL Java_HelloNative_greeting(JNIEnv* env, jclass cl) 


J 
{ 

printf("Hello Native World!\n"); 
} 





+X 
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在 这 个 简单 的 函数 中 ， 我们 忽略 了 env 和 c1 参数 。 后 面 你 会 看 到 它们 的 用 处 。 
C++ 注意 : 你 可 以 使 用 C++ 实现 本 地 方法 。 然 而 ， 那 样 你 必须 将 实现 本 地 方法 的 函数 声 
明 为 extern"C" (这 可 以 阻止 C++ 编译 器 混 编 方法 名 )。 例 如 : 


extern "C" 
JNIEXPORT void JNICALL Java_HelloNative_greeting(JNIEnv* env, jclass cl) 


cout << "Hello, Native World!" << endl; 
} 
将 本 地 C ALAS SEBS HAR BU , RTT IE RT SAE Ait o 
例如 ，Linux 下 的 Gnu C 编译 器 ， 使 用 如 下 命令 : 


gcc -fPIC -I jdk/include -I jdk/include/linux -shared -o libHelloNative.so Hel loNative.c 
如 果 是 Solaris 操作 系统 的 Sun 编译 器 ， 命 令 是 : 


cc -G -I jdk/include -I jdk/include/solaris -o libHelloNative.so HelloNative.c 


FA Windows 下 的 微软 编译 器 ， 命 令 是 : 
cl -I jdk\include -I jdk\include\win32 -LD HelloNative.c -FeHelloNative.d11 


这 里 jdk 是 含有 IDK 的 目录 。 


O 提示 : 如 果 你 要 从 命令 shell 中 使 用 微软 的 编译 器 ， 首先 要 运行 批 处 理 文 件 vcvars32 . 


bat 或 vcvarsa11.bat。 这 个 批 处 理 文件 设置 了 编译 器 需要 的 路 径 和 环境 变量 。 你 可 以 
在 目录 c:\Program Files\Microsoft Visual Studio .14.0\Common7\tools， 或 类 似 位 置 找到 该 
文件 ， 细 节 请 查看 Visual Studio 的 文档 。 


也 可 以 使 用 可 从 http://www.cygwin.com 处 免费 获取 的 Cygwin 编程 环境 。 它 包含 了 Gnu 


C 编译 器 和 Windows 下 的 UNIX 风格 编程 的 库 。 使 用 Cygwin 时 ， 用 以 下 命令 : 


gcc -mno-cygwin -D _int64="1ong long" -I jdk/include/ -I jdk/include/win32 
-shared -W],--add-stdcall-alias -o HelloNative.dl] HelloNative.c 


整个 命令 应 该 键入 在 同一 行 中 。 


注意 : Windows 版 本 的 头 文件 jni_md.h 含有 如 下 类 型 声明 : 

typedef _int64 jlong; 

它 是 专门 用 于 微软 编译 器 的 。 如 果 你 使 用 的 是 Gnu 编译 器 ， 那 么 你 就 需要 修改 这 个 文 
件 ， 例 如 : 


#ifdef _CNUC 

typedef long long jlong; 
#else 

typedef _ int64 jlong; 
#endi f 


或 者 ， 如 编译 器 调用 的 示例 那样 ， 使 用 -D __int64="long long" 进行 编译 。 
最 后 ， 我 们 要 在 程序 中 添加 一 个 对 System. 1oadLibrary 方法 的 调用 。 为 了 确保 虚拟 机 在 
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第 一 次 使 用 该 类 之 前 就 会 装载 这 个 库 ， 需 要 使 用 静态 初始 化 代码 块 ， 如 程序 清单 12-4 所 示 。 
图 12-1 给 出 了 对 本 地 代码 处 理 的 总 结 。 
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图 12-1 处 理 本 地 代码 





1 /** 
2 * @version 1.11 2007-10-26 
3 * @author Cay Horstmann 
i- + 

5 class HelloNativeTest 
6 

7 

8 

9 


{ 


public static void main(String[] args) 


{ 
Hel loNative.greeting(); 


10 } 


12 static 


3 { 
14 System. loadLibrary("Hel loNative") ; 
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15 } 
16 } 





如 果 编 译 并 运行 该 程序 ， 终 端 窗口 会 显示 消息 “Hello, Native World!” . 


注意 : 如 果 运行 在 Linux 下 ， 必 须 把 当前 目录 添加 到 库 路 径 中 。 实 现 方式 可 以 是 通过 设 
置 LD_LIBRARY_PATH 环境 变量 : 
export LD_LIBRARY_PATH=. :$LD_LIBRARY_PATH 
或 者 是 设置 java.library.path 系统 属性 : 
java -Djava.library.path=. HelloNativeTest 


当然 ， 这 个 消息 本 身 并 不 会 给 人 留 下 深刻 印象 。 然 而 ， 如 果 你 记得 这 个 信息 是 由 C 的 
printf 命令 产生 而 不 是 由 任何 Java 编程 语言 代码 产生 的 话 ， 你 就 会 明白 我 们 已 经 在 连接 两 
种 语言 上 走出 了 第 一 步 。 

总 之 ， 遵 循 下 面 的 步骤 就 可 以 将 一 个 本 地 方法 链接 到 Java 程序 中 : 

1 ) 在 Java 类 中 声明 一 个 本 地 方法 。 

2) 运行 javah 以 获得 包含 该 方法 的 C 声明 的 头 文 件 。 

3) FAC 实现 该 本 地 方法 。 

4) 将 代码 置 于 共享 类 库 中 。 

5 ) 在 Java 程序 中 加 载 该 类 库 。 





e void loadLibrary(String libname) 


装载 指定 名 字 的 库 ， 该 库 位 于 库 搜索 路 径 中 。 定 位 该 库 的 确切 方法 依赖 于 操作 系统 。 


注意 : 一些 本 地 代码 的 共享 库 必 须 先 运行 初始 化 代码 。 你 可 以 把 初始 化 代码 放 到 JNI_ 
0nLoad 方 法 中 。 类 似 地 ， 如 果 你 提供 该 方法 ， 当 虚拟 机 关闭 时 ， 将 会 调用 JNI_ 
OnUnload 方法 。 它 们 的 原型 是 : 


jint JNI_OnLoad(JavaVM* vm, void* reserved) ; 
void JNI_OnUnload(JavaVM* vm, void* reserved); 


JNI_OnLoad 方法 要 返回 它 所 需 的 虚拟 机 的 最 低 版 本 ,例如 : JINI_VERSION_1_2, 


12.2 ”数值 参数 与 返回 值 


当 在 C 和 Java 之 间 传 递 数字 时 ， 应 该 知道 它们 彼此 之 间 的 对 应 类 型 。 例 如 ,，C 也 有 int 
Al long 的 数据 类 型 ,但 是 它们 的 实现 却 是 取决 于 平台 的 。 在 一 些 平台 上 ，int 类 型 是 16 位 
的 ， 在 另外 一 些 平台 上 是 32 位 的 。 然 而 ， 在 Java 平 台 上 int 类 型 总 是 32 位 的 整数 。 基 于 
这 个 原因 ，Java 本 地 接口 定义 了 jint, jlong 等 类 型 。 
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K 12-1 显示 了 Java 数据 类 型 和 C 数据 类 型 的 对 应 关系 。 
表 12-1 Java 数据 类 型 和 C 数据 类 型 


Java 编程 语言 C 编程 语言 字 FF Java 编程 语言 C 编程 语言 字 FF 
boolean jboolean l int jint 4° 
byte jbyte 1 long jlong 8 
char jchar 2 float jfloat 4 
short jshort 2 double jdouble 8 


在 头 文件 jni.h 中 ， 这 些 类 型 被 typedef 语句 声明 为 在 目标 平台 上 等 价 的 类 型 。 该 头 
文件 还 定义 了 常量 JNI_FALSE = 0 和 JNI_TRUE = 1, 

直到 Java SE 5.0, Java 才 有 了 与 C 语言 的 printf 函数 相 类 似 的 方法 。 在 下 面 的 示例 中 ， 
我 们 假设 你 依然 坚持 使 用 古老 版 本 的 JDK， 并 且 决 定 通 过 调用 本 地 方法 中 的 C H printf K 
数 来 实现 同样 的 功能 。 

程序 清单 12-5 给 出 了 一 个 名 为 Printfl 的 类 ， 它 使 用 本 地 方法 来 打印 给 定 域 宽度 和 精 
度 的 浮 点 数 。 


as ee 
Cp on 
ay 








ToT re te ee or ee 


Best 
i 


* @version 1.10 1997-07-01 


* @author Cay Horstmann 
* 


1 
2 
3 
4 
5 class Printfl 
6 
7 
8 
9 


public static native int print(int width, int precision, double x); 


static 
10 
11 System. loadLibrary("Printf1"); 
12 } 
B } 


注意 ， 用 C 实现 该 方法 时 ， 所 有 的 int 和 double 参数 都 要 转换 成 jint 和 jdouble, 
如 程序 清单 12-6 所 示 。 





1 jes 
2 @version 1.10 1997-07-01 

3 @author Cay Horstmann 

4. 3/ 

5 

6 #include "Printfl.h" 

7 #include <stdio.h> 

8 

9 JNIEXPORT jint JNICALL Java_Printfl_print(JNIEnv* env, jclass cl, 
10 jint width, jint precision, jdouble x) 
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u { 
12 char fmt[30] ; 
13 jint ret; 


14  sprintf(fmt, "%%%d.%df", width, precision); 
15 ret = printf(fmt, x); 

16 fflush(stdout); 

17 return ret; 





该 函数 只 是 装配 了 变量 fmt 中 的 格式 字符 串 "%w.pf"， 然 后 调用 printf 函数 ， 接 看 返 


回 打印 出 的 字符 的 个 数 。 
程序 清单 12-7 给 出 了 验证 Printfl 类 的 测试 程序 。 





f** 
* @version 1.10 1997-07-01 
* @author Cay Horstmann 
* 

class PrintflTest 


public static void main(String[] args) 


ee = DG se 和 u N jx 


int count = Printfl.print(8, 4, 3.14); 

count += Printfl.print(8, 4, count); 

System. out.printinQ; 

for (int i = 0; i < count; i+) 
System.out.print("-"); 

System.out.printin(); 


he | j e e ë e * 
[= vv Aa wv N e O WW 
t 

~ 





12.3 ”字符 串 参数 


接着 ， 我 们 要 考虑 怎样 把 字符 串 传 人 、 传 出 本 地 方法 。 如 你 所 知 ，Java 编程 语言 中 的 字 
符 串 是 UTF-16 编码 点 的 序列 ， 而 C 的 字符 串 则 是 以 nu11 结尾 的 字 节 序列 ， 所 以 在 这 两 种 
语言 中 的 字符 串 是 很 不 一 样 的 。Java 本 地 接口 有 两 组 操作 字符 串 的 函数 ， 一 组 把 Java 字符 
串 转换 成 “改良 的 UTF-8” 字 节 序 列 ， 另 一 组 将 它们 转换 成 UTF-16 数值 的 数组 ， 也 就 是 说 
转换 成 jchar 数组 。( UTF-8、“ 改 良 的 UTF-8” 和 UTF-16 格式 都 已 经 在 第 2 章 中 讨论 过 了 ， 
请 回忆 一 下 , “改良 的 UTF-8” 编 码 保持 ASCI 字符 不 变 , 但 是 其 他 所 有 Unicode 字符 被 编 
码 为 多 字 节 序列 。) 
GE] 注意 : 标准 UTF-8 编码 和 “改良 的 UTF-8” 编 码 的 差别 仅 在 于 编码 大 于 0xFFFF 的 增补 

字符 。 在 标准 UTF-8 编码 中 ， 这 些 字符 编码 为 4 字 节 序列 ; 然而 ， 在 改良 的 编码 中 ， 这 

些 字符 首先 被 编码 为 一 对 UTF-16 编码 的 “替代 品 ”， 然 后 再 对 每 个 替代 品 用 UTF-8 编 
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码 ， 总 共产 生 6 字 节 编码 。 这 有 点 策 抽 ， 但 这 是 个 由 历史 原因 造成 的 意外 ， 编 写 Java 虚 
拟 机 规范 的 时 候 Unicode 还 局 限 在 16 位 。 


如 果 你 的 C 代码 已 经 使 用 了 Unicode， 那 么 你 可 以 使 用 第 二 组 转换 函数 。 另 一 方面 ， 如 
林 你 的 字符 串 都 仅 限于 使 用 ASCII 字符 ， 你 可 以 使 用 “改良 的 UTF-8” 转 换 函 数 。 

市 有 字符 串 参 数 的 本 地 方法 实际 上 都 要 接受 一 个 jstring 类 型 的 值 ， 而 带 有 字符 串 参 数 
返回 值 的 本 地 方法 必须 返回 一 个 jstring 类 型 的 值 。JNI 函数 将 读 入 并 构造 出 这 些 jstring 
对 象 。 例 如 ，NewStringUTF 函数 会 从 包含 ASCI 字符 的 字符 数组 ， 或 者 是 更 一 般 的 “改良 
的 UTF-8” 编 码 的 字 节 序列 中 ， 创 建 一 个 新 的 jstring TK. 

INI 果 数 有 一 个 有 些 古 怪 的 调用 惯例 。 下 面 是 对 NewStringUTF 函数 的 一 个 调用 : 

JNIEXPORT jstring JNICALL Java_HelloNative_getGreeting(JNIEnv* env, jclass cl) 

{ 

jstring jstr; 

char greeting[] = "Hello, Native World\n": 
jstr = (*env)->NewStringUTF(env, greeting); 
return jstr; 


} 


注意 : 本 章 中 的 所 有 代码 都 是 C 代码 ， 除 了 指明 为 别 的 代码 。 

所 有 对 INI 函数 的 调用 都 使 用 到 了 env 指针 ， 该 指针 是 每 一 个 本 地 方法 的 第 一 个 参数 。 
env 指针 是 指向 函数 指针 表 的 指针 (参见 图 12-2 )。 所 以 ， 你 必须 在 每 个 INI 调用 前 面 加 上 
(*env )->， 以 便 解 析 对 函数 指针 的 引用 。 而 且 ，env 是 每 个 INI 函数 的 第 一 个 参数 。 
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图 12-2 env 指针 


@ C++ 注意 : CH PH INI 函数 的 访问 要 简单 一 些 。JNIEnv 类 的 C++ 版 本 有 一 个 内 联 成 





Bi2~ 大 她 方法 761 


员 函 数 ， 它 负责 帮 你 查找 函数 指针 。 例 如 ， 你 可 以 这 样 调用 NewStringUTF 函数 : 
jstr = env->NewStringUTF(greet1ng) ; 
注意 ， 这 里 忽略 了 该 调用 的 参数 列表 里 的 UNIEnv 指针 。 


NewStringUTF 函数 可 以 用 来 构造 一 个 新 的 jstring， 而 读 取现 有 jstring TAWA 
容 ， 需 要 使 用 GetStringUTFChars 函数 。 该 函数 返回 指向 描述 字符 串 的 “改良 UTF-8” F 
符 的 const jbyte* 指针 。 注 意 ， 具 体 的 虚拟 机 可 以 为 其 内 部 的 字符 串 表示 方法 自由 地 选择 
编码 机 制 。 所 以 ， 你 可 以 得 到 实际 的 Java 字符 串 的 字符 指针 。 因 为 Java 字符 串 是 不 可 变 的 ， 
所 以 慎重 处 理 const 就 显得 非常 重要 ， 不 要 试图 将 数据 写 到 该 字符 数组 中 。 另 一 方面 ， 如 采 
虚拟 机 使 用 UTF-16 或 UTF-32 字符 作为 其 内 部 字符 串 的 表示 ， 那 么 该 函数 会 分 配 一 个 新 的 
内 存 块 来 存储 等 价 的 “改良 UTF-8” 编 码 字符 。 

虚拟 机 必须 知道 你 何 时 使 用 完 字 符 串 ， 这 样 它 就 能 进行 垃圾 回收 (垃圾 回收 盘 是 
在 一 个 独立 线程 中 运行 的 ， 它 能 够 中 断 本 地 方法 的 执行 )。 基 于 这 个 原因 ， 你 必须 调用 
ReleaseStringUTFChars PRA. 

另外 ， 可 以 通过 调用 GetStringRegion sy GetStringUTFRegion 方法 来 提供 你 上 自己 
的 缓存 ， 以 存放 字符 串 的 字符 。 

最 后 GetStringUTFLength 函数 返回 字符 串 的 “改良 UTF-8” 编 码 所 需 的 字符 个 数 。 


注意 : 你 可 以 在 http://docs.oracle.com/javase/7/docs/technotes/guides/jni 处 找到 JNI API. 








e jstring NewStringUTF(JNIEnv* env, const char bytes[]) 
根据 以 全 0 字 节 结尾 的 “改良 UTF-8” 字 节 序 列 ， 返 回 一 个 新 的 Java 字符 串 对 象 ， 或 
者 当 字 符 串 无 法 构建 时 ， 返 回 NULL, 

e jsize GetStringUTFLength(JNIEnv* env, jstring string) 
返回 进行 UTF-8 编码 所 需 的 字 节 个 数 。( 作 为 终止 符 的 全 0 字 节 不 计 人 内 ) 

econst jbyte* GetStringUTFChars(JNIEnv* env, jstring string, 
jboolean* isCopy) 
返回 指向 字符 串 的 “改良 UTF-8” 编 码 的 指针 ， 或 者 当 不 能 构建 字符 数组 时 返回 
NULL。 直 到 ReleaseStringUTFChars 函数 调用 前 ， 该 指针 一 直 有 效 。isCopy 指 回 
一 个 jboolean， 如 果 进 行 了 复制 ， 则 填 人 JNI_TRUE， 否 则 填 入 JNI_FALSE。 

e void ReleaseStringUTFChars(JNIEnv* env, jstring string, const jbyte 
bytes[]) 
通知 虚拟 机 本 地 代码 不 再 需要 通过 bytes (GetStringUTFChars 返回 的 指针 ) 访问 
Java 字符 串 。 


evoid GetStringRegion(JNIEnv *env, jstring string, jsize start, 


jsize length, jchar *buffer) 
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将 一 个 UTF-16 双 字 节 序 列 从 字符 串 复 制 到 用 户 提供 的 尺寸 至 少 大 于 2 x length 的 组 
FEB 

evoid GetStringUTFRegion(JNIEnv *env, jstring string, jsize start, 
jsize length, jbyte *buffer) 

将 一 个 “改良 UTF-8” 字 符 序 列 从 字符 串 复 制 到 用 户 提供 的 缓存 中 。 为 了 存放 要 复制 
的 字 节 ， 该 缓存 必须 足够 长 。 最 坏 情 况 下 ， 要 复制 3 x length 个 字 节 。 

è jstring NewString(JNIEnv* env, const jchar chars[], jsize length) 
根据 Unicode 字符 串 返 回 一 个 新 的 Java 字符 串 对 象 ， 或 者 在 不 能 构建 时 返回 NULL, 
参数 : env JNI 接口 指针 

chars 以 nul] 结尾 的 UTF-16 字符 串 
length 字符 串 中 字符 的 个 数 

e jsize GetStringLength(JNIEnv* env, jstring string) 
返回 字符 串 中 字符 的 个 数 。 

e const jchar* GetStringChars(JNIEnv* env, jstring string, jboolean* 
isCopy) 
返回 指 回 字符 串 的 Unicode 编码 的 指针 ， 或 者 当 不 能 构建 字符 数组 时 返回 NULL。 直 
到 ReleaseStringChars 函数 调用 前 ， 该 指针 一 直 有 效 。isCopy 要 么 为 NULL ; 要 
么 在 进行 了 复制 时 ， 指 癌 用 UNI_TRUE 填充 的 jboolean， 否则 指向 用 UNI_FALSE 填 
充 的 jboolean, 

e void ReleaseStringChars(JNIEnv* env, jstring string, const jchar 
charsL]) 
通知 虚拟 机 本 地 代码 不 再 需要 通过 chars (GetStringChars 返回 的 指针 ) 访问 Java 
字符 串 。 

让 我 们 使 用 这 些 函 数 来 编写 一 个 调用 C 函数 sprintf 的 类 ， 我 们 要 像 程 序 清 单 12-8 所 

ZN ABE Wed FIX TS PR 

程序 清单 12-9 给 出 了 带 有 本 地 sprint 方法 的 类 。 

因此 ， 格 式 化 浮 点 数 的 C 函数 原型 如 下 : 

JNIEXPORT jstring JNICALL Java_Printf2_sprint(JNIEnv* env, jclass cl, jstring format, jdouble x) 








et 


* @version 1.10 1997-07-01 


* @author Cay Horstmann 
* 


1 

2 

3 

4 

s class Printf?Test 
6 { 

7 public static void main(String[] args) 
8 
9 


double price = 44.95; 
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10 double tax = 7.75; 

11 double amountDue = price * (1 + tax / 100); 

12 

13 String s = Printf2.sprint("Amount due = %8.2f", amountDue) ; 
14 System.out.println(s); 





1 /** 
2 * @version 1.10 1997-07-01 
3 * @author Cay Horstmann 
4 * 

5 Class Printf2 
6 { 

7 

8 

9 


public static native String sprint(String format, double x); 


static 


{ 
11 System. loadLibrary("Printf2") ; 


程序 清单 12-10 给 出 了 C 的 实现 代码 。 注 意 ， 我 们 通过 调用 GetStringUTFChars 来 读 
取 格 式 参 数 ， 通 过 调用 NewStringUTF 来 产生 返回 值 ， 通过 调用 ReleaseStringUTFChars 
来 通知 虚拟 机 不 再 需要 访问 该 字符 串 。 





内 只 
@version 1.10 1997-07-01 
@author Cay Horstmann 

a 


#include "Printf2.h" 
#include <string.h> 
#include <stdlib.h> 
#include <float.h> 


AD o ~ Am Ae u N e 


11 [** 

1  @param format a string containing a printf format specifier 
3 (such as "%8.2f"). Substrings "%%" are skipped. 

4  Qreturn a pointer to the format specifier (skipping the '%') 
is or NULL if there wasn't a unique format specifier 

16 */ 

17 Char* find_format(const char format[]) 

18 { 

19 char* p; 

20 char* q; 


2 p= strchr(format, '%'); 
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23 while (p != NULL && *(p + 1) == '%') /* skip %% */ 

24 p = Strchr(p + 2, '%'); 

25 if (p == NULL) return NULL; 

26 /tx now check that % is unique */ 

27 D++; 

28 q = strchr(p, '%'); 

29 while (q != NULL && *(q + 1) == '%') /* skip %% */ 

30 q = strchr(q + 2, '%'); 

31 if (q != NULL) return NULL; /* % not unique */ 

32 q =p + strspn(p, " -O+#"); /* skip past flags */ 

33 q += strspn(q, "0123456789"); /* skip past field width */ 
34 if (*q == '.') { q++; q += strspn(q, "0123456789"); } 


35 /* skip past precision */ 

36 if (strchr("eEfFgG", *q) == NULL) return NULL; 

37 /* not a floating-point format */ 

38 return p; 

39 } 

40 

41 JNIEXPORT jstring JNICALL Java_Printf2_sprint(JNIEnv* env, jclass cl, 
42 jstring format, jdouble x) 


44 const char* cformat; 
45 char* fmt; 
46 jstring ret; 


48 cformat = (*env)->GetStringUTFChars(env, format, NULL); 
49 fmt = find_format (cformat) ; 
50 if (fmt == NULL) 


51 ret = format; 

52 else 

53 { 

54 char* cret; 

55 int width = atoi (fmt); 

56 if (width == 0) width = DBL_DIG + 10; 

57 cret = (char*) malloc(strlen(cformat) + width); 
58 sprintf(cret, cformat, x); 

59 ret = (*env)->NewStringUTF(env, cret); 

60 free(cret) ; 


62 (*env)->ReleaseStringUTFChars(env, format, cformat); 
63 return ret; 





ERRAR, FTG PERT CAG RADE, WRITER AARRE E Mw. pe 形式 的 
(其 中 c 是 e、E、f、g 或 6 中 的 一 个 )， 那 么 我 们 将 不 对 数字 进行 格式 化 。 后 面 我 们 会 介绍 
如 何 让 本 地 方法 抛 出 异常 。 


12.4 ”访问 域 
目前 为 止 你 看 到 的 所 有 本 地 方法 都 是 带 有 数字 或 字符 串 参 数 的 静态 方法 。 下 面 ， 我 们 








axis Pape gh 
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考虑 在 对 象 上 进行 操作 的 本 地 方法 。 作 为 一 个 练习 ， 我 们 用 本 地 方法 实现 卷 工 第 4 章 中 的 
Employee 类 的 一 个 方法 。 通 常情 况 下 并 不 需要 这 么 做 ， 但 是 这 里 演示 了 当 你 需要 的 时 候 可 
以 怎样 从 本 地 方法 访问 对 象 域 。 


12.4.1 访问 实例 域 


为 了 了 解 怎样 从 本 地 方法 访问 实例 域 ， 我 们 用 Java 重新 实现 了 raiseSalary 方法 。 其 
代码 很 简单 : 


public void raiseSalary(double byPercent) 


salary *= 1 + byPercent / 100; 


让 我 们 重 写 代码 ， 使 其 成 为 一 个 本 地 方法 。 与 此 前 的 本 地 方法 不 同 ， 它 并 不 是 一 个 静态 
方法 。 运 行 javah 给 出 以 下 原型 : 

JNIEXPORT void JNICALL Java_Employee_raiseSalary(JNIEnv *, jobject, jdouble); 

注意 ， 第 二 个 参数 不 再 是 jclass 类 型 而 是 jobject KH, LHL, EA this 引用 等 
价 。 静 态 方法 得 到 的 是 类 的 引用 ， 而 非 静态 方法 得 到 的 是 对 隐 式 的 this 参数 对 象 的 引用 。 

现在 ， 我 们 访问 隐 式 参数 的 salary 域 。 在 Javal.0 中 “原生 的 ”Java 到 C 的 绑 定 中 ， 
这 很 简单 ， 程 序 员 可 以 直接 访问 对 象 数据 域 。 然 而 ， 直 接 访 问 要 求 虚拟 机 暴露 它们 的 内 部 数 
据 布局 。 基 于 这 个 原因 ，JNI 要 求 程序 员 通过 调用 特殊 的 INI 函数 来 获取 和 设置 数据 的 值 。 

在 我 们 的 例子 里 ， 要 使 用 GetdoubleField 和 SetDoubleField pei ae, FA salary 
是 double 类 型 的 。 对 于 其 他 类 型 ， 可 以 使 用 的 函数 有 : GetIntField/SetIntField, 
GetObjectField/SetObjectField 等 等 。 其 通用 语法 是 : 


x = (*env)->GetXxxField(env, this_obj, fieldID); 
(*env)->SetXxxField(env, this_obj, fieldID, x); 


这 里 ，fie1dID 是 一 个 特殊 类 型 jfie1dID AIA, jfieldID 标识 结构 中 的 一 个 域 ， 而 
Xxx 代表 Java 数据 类 型 (0bject、Boolean、Byte 或 其 他 )。 为 了 获得 fie1dID， 必须 先 
获得 一 个 表示 类 的 值 ， 有 两 种 方法 可 以 实现 此 目的 。Get0bjectC1ass 函数 可 以 返回 任意 对 
象 的 类 。 例 如 : 
jclass class_Employee = (*env)->GetObjectClass(env, this_obj); 
FindClass 函数 可 以 让 你 以 字符 串 形 式 来 指定 类 名 (有 点 奇怪 的 是 ， 要 以 / 代替 句号 作 
为 包 名 之 间 的 分 隔 符 )。 
jclass class_String = (*env)->FindClass(env, "java/lang/String”) ; 
之 后 ， 可 以 使 用 GetFie1dID 函数 来 获得 fie1dID。 必 须 提 供 域 的 名 字 、 它 的 签名 以 及 
它 的 类 型 的 编码 。 例 如 ， 下面 是 从 salary 域 得 到 域 DD 的 代码 : 
jfieldID id_salary = (*env)->GetFieldID(env, class_Employee, "salary", "D"); 
字符 串 "D" 表示 类 型 是 double。 你 将 在 下 一 节 中 学 习 到 编码 签名 的 全 部 规则 。 
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你 可 能 会 认为 访问 数据 域 相 当 令 人 费解 。JNI 的 设计 者 不 想 把 数据 域 直接 暴露 在 外 ， 所 
以 他 们 不 得 不 提供 获取 和 设置 数据 域 值 的 函数 。 为 了 使 这 些 函 数 的 开销 最 小 化 ， 从 域名 计算 
域 ID《〈 代 价 最 大 的 一 个 步 又) 被 分 解 出 来 作为 单独 的 一 步 操作 。 也 就 是 说 ， 如 果 你 反复 地 获 
取 和 设置 一 个 特定 的 域 ， 你 计算 域 标识 符 的 开销 就 只 有 一 次 。 

让 我 们 把 各 部 分 汇总 起 来 ， 下 面 的 代码 以 本 地 方法 形式 重新 实现 了 raiseSalary 方法。 

‘an void JNICALL Java_Employee_raiseSalary(JNIEnv* env, jobject this_obj, jdouble byPercent) 


/* get the class */ 
jclass class_Employee = (*env)->GetObjectClass(env, this_obj); 


/* get the field ID */ 
jfieldID id_salary = (*env)->GetFieldID(env, class Employee, "salary", "D"); 


/* get the field value */ 
jdouble salary = (*env)->GetDoubleField(env, this_obj, id_salary); 


salary *= 1 + byPercent / 100; 
/* set the field value */ 


(*env)->SetDoubleField(env, this_obj, id_salary, Salary); 


} 





O 警告 : 类 引用 只 在 本 地 方法 返回 之 前 有 效 。 因 此 ， 不 能 在 你 的 代码 中 缓存 GetObjectClass 
的 返回 值 。 不 要 将 类 引用 保存 下 来 以 供 以 后 的 方法 调用 重复 使 用 。 必须 在 每 次 执行 本 地 方 
法 时 都 调用 Get0bjectClass。 如 果 你 无 法 忍受 这 一 点 ， 必 须 调用 NewG1oba1Ref 来 锁定 
该 引用 : 

Static jclass class_X = 0; 
Static jfieldID id_a; 


eet’ dwelt on 3 Re ie attri TY 26 Cbs eit. te hl dal ai ee ea, aw See ee 


Sf (class A == 0) 
{ 


jclass cx = (*env)->GetObjectClass(env, obj); 

class_X = (*env)->NewGlobalRef(env, cx); 

id_a = (*env)->GetFieldID(env, cls, "a", ". . ."); 
} 


现在 ， 你 可 以 在 后 面 的 调用 中 使 用 类 引用 和 域 ID 了 。 当 你 结束 对 类 的 使 用 时 ， 务 必 调 用 ， 
(*env)->DeleteGlobalRef(env, class_X): 


程序 清单 12-11 和 程序 清单 12-12 给 出 了 测试 程序 和 Employee 类 的 Java 代码 。 程 序 清 : 
单 12-13 包含 了 本 地 raiseSalary 方法 的 C 代码 。 





/** 


1 

2 * @version 1.10 1999-11-13 
3 * @author Cay Horstmann 
4 

5 


Na a tie sa DUN VW eke peer fee CCTs PS meee ae Fe eee ee eee Sh. ue, ee Taso 
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6 public class EmployeeTest 


7 { 

s public static void main(String[] args) 

9 { 

10 Employee[] staff = new Employee [3] ; 

11 

1 staff[0] = new Employee("Harry Hacker", 35000); 
13 staff [1] = new Employee("Carl Cracker", 75000); 
14 staff[2] = new Employee("Tony Tester", 38000); 
15 

16 for (Employee e : staff) 

17 e.raiseSalary(5) ; 

18 for (Employee e : staff) 

19 e.print(); 

20» } 

21 } 


ee 

* @ersion 1.10 1999-11-13 
* @author Cay Horstmann 

” 


public class Employee 

{ 
private String name; 
private double salary; 


AD oo Nu o n A v N e 


ıı public native void raiseSalary(double byPercent) ; 


3 public Employee(String n, double s) 
{ 


15 name = n; 
16 salary = S; 

17 } 

18 

13 public void print() 

20 

21 System. out.println(name +" " + salary); 
22 

23 

a static 


{ 
26 System. loadLibrary("Employee") ; 


1 /** 
2  @version 1.10 1999-11-13 
3 @author Cay Horstmann 
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4 */ | 
5 

6 #include "Employee.h" 

7 

8 #include <stdio.h> 

9 

10 JNIEXPORT void JNICALL Java_Employee_raiseSalary(JNIEnv* env, jobject this_obj, jdouble byPercent) 
u { 
12 /* get the class */ 
13 jclass class_Employee = (*env)->GetObjectClass(env, this_obj); 


a ama Aiia ed a ee 


15 /* get the field ID */ 
16 jfieldID id_salary = (*env)->GetFieldID(env, class_Employee, "salary", "D"); 


CTO N TAAT TET Po TTS 


18 /* get the field value */ 
19 jdouble salary = (*env)->GetDoubleField(env, this_obj, id_salary); 


21 Salary *= 1 + byPercent / 100; 


3  /* set the field value */ 
24 (*env)->SetDoubleField(env, this_obj, id_salary, salary); 


ee eee UULU 


12.4.2 访问 静态 域 


访问 静态 域 和 访问 非 静 态 域 类 似 。 你 要 使 用 GetStaticFieldID 和 GetStaticxxxField/ 
SetStaticXxxField MAX, Ef ULF SARA IIB EH, RAPE. 

e 由 于 没有 对 象 ， 必 须 使 用 FindClass 代替 GetObjectClass 来 获得 类 引用 。 

o 访问 域 时 ， 要 提供 类 而 非 实例 对 象 。 

例如 ， 下 面 给 出 的 是 怎样 得 到 System. out 的 引用 的 代码 : 


/* get the class */ 
jclass class System = (*env)->FindClass(env, "java/lang/System"); 


AAA Op ee ee ee ee SET ee ee ee ere, ee 2 


~~. PN V we 


/* get the field ID */ 
jfieldID id_out = (*env)->GetStaticFieldID(env, class System, "out", 
"Ljava/io/PrintStream;"); 


/* get the field value */ 
jobject obj_out = (*env)->GetStaticObjectField(env, class System, id out): 





ejfieldID GetFieldID(JNIEnv *env, jclass cl, const char name[], 
const char fieldSignature[]) 
返回 类 中 一 个 域 的 标识 符 。 
e Xxx GetXxxField(JNIEnv *env, jobject obj, jfieldID id) 
返回 域 的 值 。 域 类 型 Xxx 是 Object, Boolean, Byte. Char, Short, Int, Long, 


ee ee re ee YT eee ee ee eee) Pee ee pee eee 
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Float 或 Double 之 一 。 

e void SetXxxField(JNIEnv *env, jobject obj, jfieldID id, Xxx value) 
把 某 个 域 设 置 为 一 个 新 值 。 域 类 型 Xxx 是 Object, Boolean, Byte, Char, Short, 
Int, Long, Float 或 Double 之 一 。 

e jfieldID GetStaticFieldID(JNIEnv *env, jclass cl, const char 
name[], const char fieldSignatureL[ ]) 
返回 某 类 型 的 一 个 静态 域 的 标识 符 。 

e Xxx GetStaticXxxField(JNIEnv *env, jclass cl, jfieldID id) 
返回 某 静 态 域 的 值 。 域 类 型 Xx f Object, Boolean, Byte, Char, Short, Int, 
Long, Float 或 Double 之 一 。 

e void SetStaticXxxField(JNIEnv *env, jclass cl, jfieldID id, Xxx value) 
把 某 个 静态 域 设 置 为 一 个 新 值 。 域 类 型 Xxx j Object, Boolean, Byte, Char, 
Short. Int. Long, Float sk Double 之 一 。 


12.5 ”编码 签名 


为 了 访问 实例 域 和 调用 用 Java 编程 语言 定义 的 方法 ， 你 必须 学 习 将 数据 类 型 的 名 称 和 方 
法 签名 进行 “ 混 编 ' 的 规则 (方法 签名 描述 了 参数 和 该 方法 返回 值 的 类 型 )。 下 面 是 编码 方案 : 


B byte 

C char 

D double 
F float 

I int 

J long 
Lclassname ; 类 的 类 型 
9 short 

V void 

Z boolean 


为 了 描述 数组 类 型 ， 要 使 用 [。 例 如 ， 一 个 字符 串 数组 如 下 : 
[Ljava/lang/String; 

一 个 float[][] 可 以 描述 为 : 

[[F 


要 建立 一 个 方法 的 完整 签名 ， 需 要 把 括号 内 的 参数 类 型 都 列 出 来 ， 然 后 列 出 返回 值 类 
型 。 例 如 ， 一 个 接收 两 个 整 型 参数 并 返回 一 个 整数 的 方法 编码 为 : 


(II)I 
12.3 节 中 的 Sprint 方法 有 下 面 的 混 编 签名 : 
(Ljava/lang/String;D)Ljava/lang/String; 
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也 就 是 说 ,该 方法 接收 一 个 String 和 一 个 double， 返 回 值 是 一 个 String。 

注意 ,在 工 表达 式 结尾 处 的 分 号 是 类 型 表达 式 的 终止 符 ， 而 不 是 参数 之 间 的 分 隔 符 。 例 
如 ， 构 造句 : 

Employee(java.lang.String, double, java.util.Date) 


具有 如 下 签名 : 
"(Ljava/]ang/String;DLjava/util/Date;)V" 


TER, FED Al Ljava/util/Date; 之 间 没 有 分 隔 符 。 另 外 要 注意 在 这 个 编码 方案 中 ， 
必须 用 /代替 ， 来 分 隔 包 和 类 名 。 结 尾 的 V 表 示 返 回 类 型 为 void。 即使 对 Java 的 构造 器 没 
有 指定 返回 类 型 ， 也 需要 将 V 添加 到 虚拟 机 签名 中 。 


G 提示 : 可 以 使 用 带 有 选项 -s 的 javap 命令 来 从 类 文件 中 产生 方法 签名 。 例 如 ， 运 行 : 
javap -5 -private Employee 
可 以 得 到 以 下 显示 所 有 域 和 方法 的 输出 : 


Compiled from "Employee. java" 
public class Employee extends java.lang.Object{ 
private java.lang.String name; 
Signature: Ljava/lang/String; 
private double salary; 
Signature: D 
public Employee(java.lang.String, double); 
Signature: (Ljava/lang/String;D)V 
public native void raiseSalary (double) ; 
Signature: (D)V 
public void printQ); 
Signature: OV 
Static {}; 
Signature: ()V 


注意 : 没有 任何 理由 强迫 程序 员 使 用 这 种 混 编 方 案 来 描述 签名 。 本 地 调用 机 制 的 
设计 者 可 以 非常 容易 地 编写 一 个 函数 来 读 取 Java 编程 语言 风格 的 签名 ， 比 如 void 
(int,java.1lang.String)， 并 且 将 它们 编码 为 他 们 喜欢 的 菜 种 内 部 表示 法 。 再 者 ， 使 
用 混 编 签名 使 你 能 够 分 享 接近 虚拟 机 的 编程 奥秘 。 


12.6 ”调用 Java 方法 


当然 ，Java 编程 语言 的 函数 可 以 调用 C 函数 ， 这 正 是 本 地 方法 要 做 的 。 我 们 能 不 能 换 一 
种 方式 呢 ? 为 什么 我 们 要 这 人 么 做 ?” 答案 是 ， 本 地 方法 常常 需要 从 传递 给 它 的 对 象 那里 得 到 
茶 种 服务 。 我 们 首先 介绍 非 静 态 方法 如 何 进行 这 种 操作 ， 然 后 介绍 静态 方法 如 何 进行 这 种 
操作 。 
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12.6.1 实例 方法 


作为 从 本 地 代码 调用 Java 方法 的 一 个 例子 ， 我 们 先 增强 Printf 类 ， 给 它 增加 一 个 与 C 
函数 fprintf 类 似 的 方法 。 也 就 是 说 ， 它 能 够 在 任意 Printwriter 对 象 上 打印 一 个 字符 
串 。 下 面 是 用 Java 编写 的 该 方法 的 定义 : 


class Printf3 
public native static void fprint(PrintWriter out, String s, double x); 


, 
我 们 首先 把 要 打印 的 字符 串 组 装 成 一 个 String HA str, WARE sprint 方法 中 

已 经 实现 的 那样 。 然 后 ， 我 们 从 实现 本 地 方法 的 C 函数 中 调用 PrintWriter 类 的 print 方法 。 
使 用 如 下 函数 调用 ， 你 可 以 从 C 中 调用 任何 Java 方法 : 


(*env)->Call XxxMethod(env, implicit parameter, methodID, explicit parameters) 


根据 方法 的 返回 类 型 ， 用 Void、Int、0bject 等 来 替换 Xx。 就 像 你 需要 一 个 
FieldID 来 访问 某 个 对 象 的 一 个 域 一 样 ， 你 还 需要 一 个 方法 的 ID 来 调用 方法 。 你 可 以 通过 
调用 INI 函数 GetMethodID ， 并 且 提 供 该 类 、 方 法 的 名 字 和 方法 签名 来 获得 方法 ID。 

在 我 们 的 例子 中 ,我们 想 要 获得 PrintWriter 类 的 print 方法 的 ID。Printwriter 
类 有 几 个 名 为 print 的 重 载 方法 。 基 于 这 个 原因 ， 你 还 必须 提供 一 个 字符 串 ， 描 述 你 想 要 使 
用 的 特定 函数 的 参数 和 返回 值 。 例 如 ， 我 们 想 要 使 用 void print(java.1ang.String)， 
正如 前 一 节 讲 到 的 那样 ， 我 们 必须 把 签名 “ 混 编 ”为 字符 串 "(Ljava/1ang/String;)V"。 

下 面 是 进行 方法 调用 的 完整 代码 ， 有 以 下 几 个 步骤 : 

1) 获取 隐 式 参数 的 类 。 

2 ) 获取 方法 ID。 

3 ) 进行 调用 。 

/* get the class */ 


class PrintWriter = (*env)->GetObjectClass(env, out); 


/* get the method ID */ 
id_print = (*env)->GetMethodID(env, class PrintWriter, "print", "(Ljava/lang/String;)V") ; 


/* call the method */ 
(*env)->CallVoidMethod(env, out, id_print, str); 


程序 清单 12-14 和 12-15 给 出 了 测试 程序 和 Printf3 类 的 Java 代码 。 程 序 清单 12-16 包 
含 了 本 地 fprintf 方法 的 C 代码 。 


注意 : 数值 型 的 方法 ID 和 域 ID 在 概念 上 和 反射 API 中 的 Method Fe Field 对 象 相似 。 
你 可 以 使 用 以 下 函数 在 两 者 间 进 行 转换 : 
jobject ToReflectedMethod(JNIEnv* env, jclass class, jmethodID methodID) ; 


// returns Method object 
methodID FromReflectedMethod(JNIEnv* env, jobject method) ; 
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jobject ToReflectedField(JNIEnv* env, jclass class, jfieldID fieldID); 


// returns Field object 


FieldID FromReflectedField(JNIEnv* env, jobject field); 
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import java.io. *; 


/** 
* @version 1.10 1997-07-01 
* @author Cay Horstmann 
yf 
class Printf3Test 
{ 
public static void main(String[] args) 
{ 
double price = 44.95; 
double tax = 7.75; 
double amountDue = price * (1 + tax / 100); 
PrintWriter out = new PrintWriter(System.out) ; 
Printf3.fprint(out, "Amount due = %8.2f\n", amountDue) ; 
out. flush(Q); 





import java.io.*; 


/** 
* @ersion 1.10 1997-07-01 
* @author Cay Horstmann 
* 

class Printf3 


{ 


public static native void fprint(PrintWriter out, String format, double x); 


static 
{ 
System. loadLibrary("Printf3") ; 
} 
} 





/** 
@version 1.10 1997-07-01 
@author Cay Horstmann 


ii 


#include "Printf3.h" 
#include <string.h> 
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s #include <stdlib.h> 
9 #include <float.h> 


11 /** 

2  @param format a string containing a printf format specifier 
1 (such as "%8.2f"). Substrings "%%" are skipped. 

14  @return a pointer to the format specifier (skipping the '%') 
15 or NULL if there wasn't a unique format specifier 

16 */ 

17 char* find_format(const char format []) 

18 { 

19 char* p; 

20 char* q; 


22 p = strchr(format, '%'); 

23 while (p != NULL && *(p + 1) == '%') /* skip %% */ 

24 p = strchr(p + 2, '%'); 

25 if (p == NULL) return NULL; 

2  /* now check that % is unique */ 

27 p++; 

28 q= Strchr(p, '%'); 

29 while (q != NULL & *(q + 1) == '%') /* skip %% */ 

30 = Strchr(q + 2, '%'); 

31 if (q != NULL) return NULL; /* % not unique */ 

2 g=p+strspn(p, " -0+#"); /* skip past flags */ 

3 q += Strspn(q, "0123456789"); /* skip past field width */ 
34 if (*q == '.") { q+; q += strspn(q, "0123456789"); } 


35 /* skip past precision */ 

36 if (strchr("eEfFgG", *q) == NULL) return NULL; 

37 /* not a floating-point format */ 

33 return p; 

39 } 

40 

41 JNIEXPORT void JNICALL Java_Printf3_fprint(JNIEnv* env, jclass cl, 
42 jobject out, jstring format, jdouble x) 


44 const char* cformat; 

45 char* fmt; 

46  jstring str; 

47 jclass class_PrintWriter; 
48 jmethodID id_print; 


so Cformat = (*env)->GetStringUTFChars(env, format, NULL); 
sı fmt = find_format(cformat) ; 
52 if (fmt == NULL) 


53 str = format; 

54 else 

55 { 

56 char* cstr; 

57 int width = atoi (fmt) ; 

58 if (width == 0) width = DBL_DIG + 10; 

59 cstr = (char*) malloc(strlen(cformat) + width); 
60 sprintf(cstr, cformat, x); 

61 str = (*env)->NewStringUTF(env, cstr); 
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62 free(cstr); 
64 (*env)->ReleaseStringUTFChars(env, format, cformat); 
66 /* now call ps.print(str) */ 


68 /* get the class */ 
69 class PrintWriter = (*env)->GetObjectClass(env, out); 


71 /* get the method ID */ 
z idprint = (*env)->GetMethodID(env, class_PrintWriter, "print", "(Ljava/lang/String;)V"); 


74 /* call the method */ 
75 (*env)->CallVoidMethod(env, out, id_print, str); 





12.6.2 ”静态 方法 


从 本 地 方法 调用 静态 方法 与 调用 非 静态 方法 类 似 。 两 者 的 差别 是 ; 

e 要 用 GetStaticMethodID 和 CallStaticXxxMethod pay. 

e 当 调 用 方法 时 ， 要 提供 类 对 象 ， 而 不 是 隐 式 的 参数 对 象 。 

作为 一 个 例子 ， 让 我 们 从 本 地 方法 调用 以 下 静态 方法 : 

System. getProperty("java.class. path") 

这 个 调用 的 返回 值 是 给 出 了 当前 类 路 径 的 字符 串 。 

首先 ， 我 们 必须 找到 要 用 的 类 。 因 为 我 们 没有 System 类 的 对 象 可 供 使 用 ， 所 以 我 们 使 
FA FindClass 而 非 GetObjectClass: 
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jclass class System = (*env)->FindClass(env, "java/lang/System") ; 

接着 ， 我 们 需要 静态 getProperty 方法 的 ID。 该 方法 的 编码 签名 是 
"(Ljava/Tang/String;)Ljava/lang/String;" 

既然 参数 和 返回 值 都 是 字符 串 。 因 此 ， 我 们 这 样 获 取 方 法 ID: 


jmethodID id_getProperty = (*env)->GetStaticMethodID(env, class_System, "getProperty", 
"(Ljava/lang/String;)Ljava/lang/String;"); 


最 后 ， 我 们 进行 调 有 用。 注意， 类 对象 被 传递 给 了 CallStaticObjectMethod 函数 。 


jobject obj_ret = (*env)->CallStaticObjectMethod(env, class_System, id_getProperty, 
(*env)->NewStringUTF(env, "java.class.path")); 


该 方法 的 返回 值 是 jobject 类 型 的 。 如 果 我 们 想 要 把 它 当 作 字 符 吕 操作， 必须 把 它 转型 
为 jstring: 


jstring str_ret = (jstring) obj_ret; 


@ C++ 注意 : ACH, jstring 和 jclass 类 型 同 后 面 将 要 介绍 的 数组 类 型 一 样 ， 都 是 与 
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jobject 等 价 的 类 型 。 因 此 ， 在 C 语 言 中 ， 前 面 例子 中 的 转型 并 不 是 严格 必需 的 。 但 是 
在 C++ 中 ， 这 些 类 型 被 定义 为 指向 拥有 正确 继承 层次 关系 的 “ 哑 类 ”的 指针 。 例 如 ， 将 
一 个 jstring 不 经 过 转型 便 赋 给 jobject 在 C++ 中 是 合法 的 ， 但 是 将 jobject 赋 给 
jstring 必须 先 转 型 。 


12.6.3 ”构造 器 


本 地 方法 可 以 通过 调用 构造 器 来 创建 新 的 Java 对 象 。 可 以 调用 NewObject 函数 来 调用 
PATE A o 
jobject obj_new = (*env)->NewObject(env, class, methodID, construction parameters) ; 


可 以 通过 指定 方法 名 为 "<init>"， 并 指定 构造 器 (返回 值 为 void) 的 编码 签 
名 ， 从 GetMethodID 函数 中 获取 该 调用 必需 的 方法 IDP。 例 如 ， 下 面 是 本 地 方法 创建 
FileOutputStream 对 象 的 情形 : 


const char[] fileName="...; 
jstring str_fileName = (*env)->NewStringUTF(env, fileName) ; 
jclass class_FileOutputStream = (*env)->FindClass(env, "java/io/FileOutputStream’) ; 
jmethodID id_FileOutputStream 

= (*env)->GetMethodID(env, class_FileOutputStream, "<init>", "(Ljava/lang/String;)V") ; 
jobject obj_stream 

= (*env)->NewObject(env, class_FileQutputStream, id_FileQutputStream, str_fileName) ; 


注意 ,构造 器 的 签名 接受 一 个 java.lang.String 类 型 的 参数 ， 返 回 类 型 为 void。 
12.6.4 ” 另 一 种 方法 调用 


有 若干 种 JNI 函数 的 变 体 都 可 以 从 本 地 代码 调用 Java 方法 。 它 们 没有 我 们 已 经 讨论 过 的 
那些 函数 那么 重要 ， 但 有 偶尔 也 会 很 有 用 。 

Cal1NonvirtualLtaMethod 函数 接收 一 个 隐 式 参数 、 一 个 方法 ID 、 一 个 类 对 象 〈 必 须 
对 应 于 隐 式 参数 的 超 类 ) 和 一 个 显 式 参数 。 这 个 函数 将 调用 指定 的 类 中 的 指定 版 本 的 方法 ， 
而 不 使 用 常规 的 动态 调度 机 制 。 

所 有 调用 函数 都 有 后 级 "A" 和 "V" 的 版 本 ， 用 于 接收 数组 中 或 va_1ist 中 的 显 式 参数 
(就 像 在 C 头 文件 stdarg.h 中 所 定义 的 那样 )。 





e jmethodID GetMethodID(JNIEnv *env, jclass cl, const char nameL], 
const char methodSignatureL ]) 
返回 类 中 某 个 方法 的 标识 符 。 

e Xxx CallXxxMethod(JNIEnv *env, jobject obj, jmethodID id, args) 

e Xxx CallXxxMethodA(JNIEnv *env, jobject obj, jmethodID id, jvalue 
args[]) 
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e Xxx CallXxxMethodV(JNIEnv *env, jobject obj, jmethodID id, va_list 
args) 
调用 一 个 方法 。 返 回 类 型 Xxx £2 Object, Boolean, Byte, Char. Short, Int, 
Long, Float 或 Double 之 一 。 第 一 个 函数 有 可 变数 量 参数 ， 只 要 把 方法 参数 附加 到 
方法 ID 之 后 即 可 。 第 二 个 函数 接受 jvalue 数组 中 的 方法 参数 ， 其 中 jvalue 是 一 个 
联合 体 ， 定 义 如 下 : 


typedef union jvalue 


jboolean z; 
jbyte b; 
jchar c; 
jshort s; 
jint i; 
jlong j; 
jfloat f; 
jdouble d; 
jobject 1; 
} jvalue; 


第 三 个 函数 接收 C 头 文件 stdarg.h 中 定义 的 va_list 中 的 方法 参数 。 
e Xxx CallNonvirtualXxxMethod(JNIEnv *env, jobject obj, jclass cl, 
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jmethodID id, args) 

e Xxx CallNonvirtualXxxMethodA(JNIEnv *env, jobject obj, jclass cl, 
jmethodID id, jvalue args[]) 

e Xxx CallNonvirtualXxxMethodV(JNIEnv *env, jobject obj, jclass cl, 
jmethodID id, va_list args) 
调用 一 个 方法 ， 并 绕 过 动态 调度 。 返 回 类 型 Xxx 是 0bject、Boolean、Byte、Char、 
Short, Int, Long, Float 或 Double 之 一 。 第 一 个 函数 有 可 变数 量 参 数 ， 只 要 把 方 
法 参数 附加 到 方法 ID 之 后 即 可 。 第 二 个 函数 接受 jvalue 数组 中 的 方法 参数 。 第 三 个 
pRB ESS C 头 文件 stdarg.h 中 定义 的 va_list 中 的 方法 参数 。 

e jmethodID GetStaticMethodID(JNIEnv *env, jclass cl, const char 
name[], const char methodSignatureL ]) 
1B [BIS FET RAST TE TAF 

e Xxx CallStaticXxxMethod(JNIEnv *env, jclass cl, jmethodID id, args) 

e Xxx CallStaticXxxMethodAC(JNIEnv *env, jclass cl, jmethodID id, 
jvalue args[]) 

è Xxx CallStaticXxxMethodV(JNIEnv *env, jclass cl, jmethodID id, va_ 
list args) 
val A — ARAD. 18 El% AY Xxx Æ Object, Boolean, Byte, Char, Short, 

Int, Long, Float # Double 之 一 。 第 一 个 函数 有 可 变数 量 参数 ， 只 要 把 方法 参数 
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附加 到 方法 ID 之 后 即 可 。 第 二 个 函数 接受 jvalue 数组 中 的 方法 参数 。 第 三 个 函数 接 
受 C 头 文件 stdarg.h 中 定义 的 va_1ist 中 的 方法 参数 。 

e jobject NewObject(JNIEnv *env, jclass cl, jmethodID id, args) 

e jobject NewObjectA(JNIEnv *env, jclass cl, jmethodID id, jvalue args[]) 

e jobject NewObjectV(JNIEnv *env, jclass cl, jmethodID id, va_list args) 
调用 构造 器 。 函 数 ID 从 带 有 函数 名 为 "<init>" 和 返回 类 型 为 void 的 GetMethodID 
获取 。 第 一 个 函数 有 可 变数 量 参数 ， 只 要 把 方法 参数 附加 到 方法 ID 之 后 即 可 。 第 二 个 
函数 接收 jvalue 数组 中 的 方法 参数 。 第 三 个 函数 接收 C 头 文件 stdarg.h 中 定义 的 
va_list 中 的 方法 参数 。 


12.7 ”访问 数组 元 素 


Java 编程 语言 的 所 有 数组 类 型 都 有 相对 应 的 C 语言 类 型 ， 见 表 12-2。 
表 12-2 Java 数组 类 型 和 C 数组 类 型 之 间 的 对 应 关系 


Java 数组 类 型 C 数组 类 型 Java 数组 类 型 C 数组 类 型 
boolean[] jbooleanArray long[] jlongArray 
byte[ ] jbyteArray float[] jfloatArray 
char[] jcharArray double[ ] jdoubleArray 
int[] jintArray Object[] jobjectArray 
short[] jshortArray 


@ C++ 注意 : 在 C 中 ， 所 有 这 些 数组 类 型 实际 上 都 是 jobject HALRB. Am, Æ 
C++ 中 它们 被 安排 在 如 图 12-3 所 示 的 继承 层次 结构 中 。jarray 类 型 表示 一 个 通用 数组 。 


GetArrayLength 函数 返回 数组 的 长 度 。 


jarray array = ，，,; 
jsize length = (*env)->GetArrayLength(env, array) ; 


怎样 访问 数组 元 素 取决 于 数组 中 存储 的 是 对 象 还 是 基本 类 型 的 数据 (如 bool, char 或 
数值 类 型 )。 可 以 通过 GetObjectArrayElement 和 SetObjectArrayE1ement 方法 访问 对 
象 数组 的 元 素 。 

jobjectArray array =.. .; 

int i, i 

jobject x = (*env)->GetObjectArrayElement(env, array, i); 

(*env)->SetObjectArrayElement(env, array, j, x); 


这 个 方法 虽然 简单 ， 但 是 效率 明显 低下 ， 当 你 想 要 直接 访问 数组 元 素 ， 特 别 是 在 进行 回 
量 或 矩阵 计算 时 更 是 如 此 。 

GetXxxArrayElements 函数 返回 一 个 指向 数组 起 始 元 素 的 C 指针 。 与 普通 的 字符 趾 
一 样 ， 当 你 不 再 需要 该 指针 时 ， 必 须 记 得 要 调用 ReleaseXxxArrayElements 函数 通知 虚 
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拟 机 。 这 里 ， 类 型 Xxx 必须 是 基本 类 型 ， 也 就 是 说 ， 不 能 是 0bject。 这 样 就 可 以 直接 读 
写 数 组 元 素 了 。 男 一 方面 ， 由 于 指针 可 能 会 指向 一 个 副本 ,只 有 调用 相应 的 ReleaseXxx- 
ArrayElements 图 数 时 ， 你 所 做 的 改变 才能 保证 在 源 数 组 里 得 到 反映 。 
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图 12-3 ”数组 类 型 的 继承 层次 结构 


注意 : 通过 把 一 个 指向 jboolean 变量 的 指针 作为 第 三 个 参数 传递 给 GetXxxArray- 
Elements 方法 ， 就 可 以 发 现 一 个 数组 是 否 是 副本 了 。 如 果 是 副本 ， 则 该 变量 被 JNI_ 
TRUE 填充 。 如 果 你 对 这 个 信息 不 感 兴趣 ， 传 一 个 空 指 针 即 可 。 


下 面 是 对 double 类 型 数组 中 的 所 有 元 素 乘 以 一 个 常量 的 示例 代码 。 我 们 获取 一 个 Java 
数组 的 C 指针 a， 并 用 alil 访问 各 个 元 素 。 


jdoubleArray arraya=...; 

double scaleFactor = . 

double* a = (*env)- ->GetDoubleArrayElenents (env, array_a, NULL); 
for (i = 0; i < (*env)->GetArrayLength(env, array_a); i++) 
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a[i] = a[i] * scaleFactor; 
(*env)->ReleaseDoubleArrayElements(env, array_a, a, 0); 


虚拟 机 是 否 确实 需要 对 数组 进行 拷贝 取决 于 它 是 如 何 分 配 数 组 和 如 何 进行 垃圾 回收 的 。 
有 些 “ 拷 贝 ”型 的 垃圾 回收 器 例 行 地 移动 对 象 ， 并 更 新 对 象 引 用 。 该 策略 与 将 数组 锁定 在 特 
定位 置 是 不 兼容 的 ， 因 为 回收 器 不 能 更 新 本 地 代码 中 的 指针 值 。 


注意 : Orade 的 JVM 实现 中 ,boolean 数组 是 用 打包 的 32 位 字数 组 表示 的 。GetBoolean 
ArrayElements 方法 能 将 它们 复制 到 拆 包 的 jboolean 值 的 数组 中 。 


如 果 要 访问 一 个 大 数组 的 多 个 元 素 ， 可 以 用 GetXxxArrayRegion 和 Set XxxArray-— 
Region 方法 ， 它 能 把 一 定 范围 内 的 元 素 从 Java 数组 复制 到 C 数组 中 或 从 C 数组 复制 到 Java 
数组 中 。 

可 以 用 NewXxxArray 函数 在 本 地 方法 中 创建 新 的 Java 数组 。 要 创建 新 的 对 象 数组 ， 需 
要 指定 长 度 、 数 组 元 素 的 类 型 和 所 有 元 素 的 初始 值 ( 典 型 的 是 NULL)。 下 面 是 一 个 例子 。 


jclass class_Employee = (*env)->FindClass(env, "Employee") ; 
jobjectArray array_e = (*env)->NewObjectArray(env, 100, class_Employee, NULL) ; 


基本 类 型 的 数组 要 简单 一 些 。 只 需 提供 数组 长 度 。 
jdoubleArray array_d = (*env)->NewDoubleArray(env, 100); 
该 数组 被 0 填充 。 


注意 : 下 面 的 方法 用 来 操作 “直接 缓存 ”: 
jobject NewDirectByteBuffer(JNIEnv* env, void* address, jlong capacity) 


void? GetDirectBufferAddress(JNIEnv* env, jobject buf) 
jlong GetDirectBufferCapacity(JNIEnv* env, jobject buf) 


java.nio 包 中 使 用 了 直接 缓存 来 支持 更 高 效 的 输入 输出 操作 ， 并 尽 可 能 减少 本 地 和 Java 
数组 之 间 的 复制 操作 。 





è jsize GetArrayLength(JNIEnv *env, jarray array) 
返回 数组 中 的 元 素 个 数 。 

e jobject GetObjectArrayElement(JNIEnv *env, jobjectArray array, 
jsize index) 
返回 数组 元 素 的 值 。 

e void SetObjectArrayElement(JNIEnv *env, jobjectArray array, jsize 
index, jobject value) 
将 数组 元 素 设 为 新 值 。 

e YXxx* GetXxxArrayElements(JNIEnv *env, jarray array, jboolean* isCopy) 


产生 一 个 指向 Java 数 组 元 素 的 C 指 针 。 域 类 型 Xx 是 Boolean、Byte、Char、 
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Short, Int, Long, Float B Double 之 一 。 指 针 不 再 使 用 时 ， 该 指针 必须 传递 给 
ReleaseXxxArrayElements, iscopy 可 能 是 NULL， 或 者 在 进行 了 复制 时 ， 指 向 用 
JNI_TRUE 填充 的 jboolean; 否则 ， 指 向 用 JNI_FALSE 填充 的 jboolean 

evoid ReleaseXxxArrayElements(JNIEnv *env, jarray array, Xxx 
elems[], jint mode) 
通知 虚拟 机 通过 GetXxxArrayElements 获得 的 一 个 指针 已 经 不 再 需要 了 。Mode 是 0 
(更 新 数组 元 素 后 释放 elems 缓存 )、JNI_COMMIT (更 新 数组 元 素 后 不 释放 elems 缓存 ) 
或 UNI_ABORT (不 更 新 数组 元 素 便 释放 elems 缓存 ) 之 一 。 

® void GetXxxArrayRegion(JNIEnv *env, jarray array, jint start, jint 
length, Xxx elems[]) 
将 Java 数组 的 元 素 复制 到 C 数组 中 。 域 类 型 Xxx 是 Boolean, Byte, Char. Short. 
Int, Long, Float 或 Double 之 一 。 

evoid SetXxxArrayRegion(JNIEnv *env, jarray array, jint start, jint 
length, Xxx elems[]) 
将 C 数组 的 元 素 复制 到 Java 数组 中 。 域 类 型 Xxx 是 Boolean, Byte, Char. Short. 
Int, Long, Float 或 Double 之 一 。 


12.8 ”错误 处 理 


在 Java 编程 语言 中 ,使 用 本 地 方法 对 于 程序 来 说 是 要 冒 很 大 的 安全 风险 的 。C 的 运行 期 
系统 对 数组 越界 错误 、 不 良 指针 造成 的 间接 错误 等 不 提供 任何 防护 。 所 以 ， 对 于 本 地 方法 的 
程序 员 来 说 ， 处 理 所 有 的 出 错 条 件 以 保持 Java 平 台 的 完整 性 显得 格外 重要 。 尤 其 是 ， 当 你 
的 本 地 方法 诊断 出 一 个 它 无 法 解决 的 问题 时 ， 那 么 它 应 该 将 此 问题 报告 给 Java 虚拟 机 。 然 
后 ， 在 这 种 情况 下 ， 很 自然 地 会 抛 出 一 个 异常 。 然 而 ，C 语言 没有 异常 ， 必 须 调用 Throw 或 
ThrowNew 上 盟 数 来 创建 一 个 新 的 异常 对 象 。 当 本 地 方法 退出 时 ，Java 虚拟 机 就 会 抛 出 该 异常 。 

要 使 用 Throw 函数 ， 需 要 调用 NewObject 来 创建 一 个 Throwable 子 类 的 对 象 。 例 如 ， 
下 面 我 们 分 配 了 一 个 EOFException 对 象 ， 然 后 将 它 抛 出 。 


jclass class_EOFException = (*env)->FindClass(env, "java/io/EOFException"); 

jmethodID id_EOFException = (*env)->GetMethodID(env, class_EOFException, "<init>", "OV"); 
/* ID of no-argument constructor */ 

jthrowable obj_exc = (*env)->NewObject(env, class_EOFException, id_EOFException); 

(*env)->Throw(env, obj_exc); 


iH 7s DFA ThrowNew 会 更 加 方便 ， 因 为 只 需 提供 一 个 类 和 一 个 “改良 UTF-8” 字 节 序 列 ， 
该 函数 就 会 构建 一 个 异常 对 象 。 

(*env)->ThrowNew(env, (*env)->FindClass(env, "java/io/EOFException"), "Unexpected end of file"); 

Throw 和 ThrowNew 都 仅仅 只 是 发 布 异常 ， 它 们 不 会 中 断 本 地 方法 的 控制 流 。 只 有 当 该 
方法 返回 时 ，Java 虚拟 机 才 会 抛 出 异常 。 所 以 ， 每 一 个 对 Throw 和 ThrowNew 的 调用 语句 之 
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后 总 是 紧 跟 着 return 语句 。 


@ C++ 注意 : RACH 实现 本 地 方法 ， 那 么 就 无 法 用 你 的 C++ 代码 抛 出 Java 异常 。 在 
C++ 绑 定 中 ， 是 可 以 实现 一 个 在 C++ 异常 和 Java 异常 之 间 的 转换 的 。 然 而 ， 到 目前 为 
止 还 没有 实现 这 个 功能 。 需 要 在 本 地 方法 中 使 用 Throw 或 ThrowNew 函数 来 抛 出 Java 
异常 ， 并 且 要 确保 你 的 本 地 方法 不 抛 出 C++ 异常 。 


通常 ， 本 地 代码 不 需要 考虑 捕获 Java 异常 。 但 是 ， 当 本 地 方法 调用 Java 方法 时 ， 该 方 
法 可 能 会 抛 出 异常 。 而 且 ， 一些 INI 函数 也 会 抛 出 异常 。 例 如 ， 如 果 索 引 越界 , SetObjecta 
rrayElement 方法 会 抛 出 一 个 ArrayIndex0ut0fBoundsException 异常 ， 如 果 所 存储 的 
对 象 的 类 不 是 数组 元 素 类 的 子 类 ， 该 方法 会 抛 出 一 个 ArrayStoreException 异常 。 在 这 类 
情况 下 ， 本 地 方法 应 该 调用 ExceptionOccurred 方法 来 确认 是 否 有 异常 抛 出 。 如 果 没 有 任 
何 异常 等 待 处 理 ， 则 下 面 的 调用 : 


jthrowable obj_exc = (*env)->ExceptionOccurred(eny) ; 


将 返回 NULL。 否 则 ， 返 回 一 个 当前 异常 对 象 的 引用 。 如 果 只 要 检查 是 否 有 异常 抛 出 ， 
而 不 需要 获得 异常 对 象 的 引用 ， 那 么 应 使 用 : 


jboolean occurred = (*env)->ExceptionCheck(env); 


通常 ， 有 异常 出 现时 ， 本 地 方法 应 该 直接 返回 。 那 样 ， 虚 拟 机 就 会 将 该 异常 传送 给 Java 
代码 。 但 是 ， 本 地 方法 也 可 以 分 析 异 常 对 象 ， 确 定 它 是 否 能 够 处 理 该 异常 。 如 采 能 够 处 理 ， 
那么 必须 调用 下 面 的 函数 来 关闭 该 异常 : 


(*env)->ExceptionClear (env); 


在 我 们 的 例子 中 ， 我 们 实现 了 fprint 本 地 方法 ， 这 是 基于 该 方法 适合 编写 为 本 地 方法 
的 假设 而 实现 的 。 下 面 是 我 们 抛 出 的 异常 : 

e 如 果 格 式 字符 串 是 NULL， 则 抛 出 Nu11PointerException AR o 

e 如 果 格 式 字符 串 不 含 适合 打印 double 所 需 的 % 说 明 符 ， 则 抛 出 111egalArgument— 

Exception ##. 

e 如 果 调 用 ma11oc 失败 ， 则 抛 出 OutOfMemoryError 异常 。 

最 后 ， 为 了 说 明 本 地 方法 调用 Java 方 法 时 ， 怎 样 检查 异常 ， 我 们 将 一 个 字符 串 发 送 给 
数据 流 ， 一 次 一 个 字符 ， 并 且 在 每 次 调用 Java 方 法 后 调用 Exception0ccurred。 程 序 清 
单 12-17 给 出 了 本 地 方法 的 代码 ， 程 序 清 单 12-18 展示 了 含有 本 地 方法 的 类 的 定义 。 注 意 ， 
在 调用 Printwriter.print 出 现 异常 时 ， 本 地 方法 并 不 会 立即 终止 执行 ， 它 会 首先 释放 
cstr 缓存 。 当 本 地 方法 返回 时 ， 虚 拟 机 再 次 抛 出 异常 。 程 序 清单 12-19 的 测试 程序 说 明了 当 
格式 字符 串 无 效 时 ， 本 地 方法 是 如 何 抛 出 异常 的 。 





1 /** 
2 @version 1.10 1997-07-01 
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@author Cay Horstmann 


"| 


3 
4 

5 

6 #include "Printf4.h" 
7 #include <string.h> 
8 #include <stdlib.h> 
9 #include <float.h> 





u /** 
12 @param format a string containing a printf format specifier 


a i 2 


13 (such as "%8.2f"). Substrings "%%" are skipped. 
14 @return a pointer to the format specifier (skipping the '%') 
15 or NULL if there wasn't a unique format specifier | 
16 */ 
17 Char* find_format(const char format []) | 
18 { 
19 Char* p; | 
2 Char* q; : 


,Zc Jone Ss Pia 


2 = p= Strchr(format, '%'); 
23 while (p != NULL && *(p + 1) == '%') /* skip %% */ 
24 p = strchr(p + 2, '%'); 

25 if (p == NULL) return NULL; 

26 /* now check that % is unique */ 

27 p++; 

28 q= Strchr(p, '%'); 

23 while (q != NULL && *(q + 1) == '%') /* skip %% */ 

30 q = strchr(q + 2, '%'); 

31 if (q != NULL) return NULL; /* % not unique */ 

32 q= p+ strspn(p, " -0+#"); /* skip past flags */ 

33 q += strspn(q, "0123456789"); /* skip past field width */ 
34 if (*q == '.") { g++; q += strspn(q, "0123456789"); } 


35 /* skip past precision */ 

36 1f (strchr("eEfFgG", *q) == NULL) return NULL; 

37 /* not a floating-point format */ 

38 return p; 

39 } 

40 

41 JNIEXPORT void JNICALL Java_Printf4_fprint(JNIEnv* env, jclass cl, 
42 jobject out, jstring format, jdouble x) 

3 { 


44 const char* cformat; 

45 char* fmt; 

46 jclass class_PrintWriter; 
47 jmethodID id_print; 

48 char* cstr; 

49 int width; 

50 int i; 


52 if (format == NULL) 
{ 
54 (*env)->ThrowNew(env, 


55 (*env)->FindClass (env, 
56 "java/1ang/Nul1PointerException") , 
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m "Printf4.fprint: format is null"); 
s8 return; 
9} 


sı cformat = (*env)->GetStringUTFChars(env, format, NULL); 
62 fmt = find_format(cformat) ; 


64 if (fmt == NULL) 


66 (*env)->ThrowNew(env, 

67 (*env)->FindClass(env, 

68 "java/1ang/I1legalArgumentException’) , 
69 "Printf4.fprint: format is invalid"); 
70 return; 

71 } 


23 width = atoi (fmt); 
14 if (width == 0) width = DBL_DIG + 10; 
75 cstr = (char*)malloc(strlen(cformat) + width); 


17 if (cstr == NULL) 


79 (*env)->ThrowNew(env, 

80 (*env)->FindClass(env, "java/lang/OutOfMemoryError"), 
81 "Printf4.fprint: malloc failed"); 

82 return; 

83 } 


85 sprintf(cstr, cformat, x); 
87 (*env)->ReleaseStringUTFChars(env, format, cformat) ; 
89 /* now call ps.print(str) */ 


a  /* get the class */ 
92 class PrintWriter = (*env)->GetObjectClass(env, out); 


94 /* get the method ID */ 
ss  id_print = (*env)->GetMethodID(env, class_PrintWriter, "print", "(Q)V"); 


9 /* call the method */ 
9 for (i = 0; cstr[i] != 0 && !(*env)->ExceptionOccurred(env); i++) 
99 (*env)->CallVoidMethod(env, out, id_print, cstr[i]); 


101  free(cstr); 





import java.io.*; 


/** 


* @version 1.10 1997-07-01 


a w N p 
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* @author Cay Horstmann 
*/ 


5 
6 
7 class Printf4 
8 
9 


public static native void fprint(PrintWriter ps, String format, double x); 


11 static 


{ 
13 System. loadLibrary("Printf4") ; 





1 import java.io.*; 
2 





3 /** 

4 * @ersion 1.10 1997-07-01 

5 * @author Cay Horstmann 

6 */ 

7 Class Printf4Test 

a { 

9 public static void main(String[] args) 

10 

11 double price = 44.95; 

12 double tax = 7.75; 

13 double amountDue = price * (1 + tax / 100); 

14 PrintWriter out = new PrintWriter(System.out) ; 

15 /* This call will throw an exception--note the %% */ 
16 Printf4.fprint(out, "Amount due = %%8.2f\n", amountDue) ; 


17 out. flush(); 





e jint Throw(JNIEnv *env, jthrowable obj) 
准备 一 个 在 本 地 代码 退出 时 抛 出 的 异常 。 成 功 时 返回 0， 失败 时 返回 一 个 负 值 。 
è jint ThrowNew(JNIEnv *env, jclass cl, const char msg[]) 
准备 一 个 在 本 地 代码 退出 时 抛 出 的 类 型 为 c1 的 异常 。 成 功 时 返回 0， 失败 时 返回 一 个 
负 值 。msg 是 表示 异常 对 象 的 String 构造 参数 的 “改良 UTF-8” 字 节 序 列 
e jthrowable ExceptionOccurred(JNIEnv *env) 
如 有 果 有 异常 挂 起 ， 则 返回 该 异常 对 象 ， 否 则 返回 NULL, 


è jboolean ExceptionCheck(JNIEnv *env) 


如 果 有 异常 挂 起 ， 则 返回 true, 


evoid ExceptionClear(JNIEnv *env) 


清除 挂 起 的 异常 。 
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12.9 使 用 调用 API 


到 现在 为 止 ， 我 们 主要 讨论 的 都 是 进行 了 一 些 C 调用 的 用 Java 编程 语言 编写 的 程序 ， 
这 大 概 是 因为 C 的 运行 速度 更 快 一 些 ， 或 者 允许 访问 一 些 Java 平台 无 法 访问 的 功能 。 假 设 
在 相反 的 情况 下 ， 你 有 一 个 C 或 者 C++ 的 程序 ， 并 且 想 要 调用 一 些 Java 代码 。 调 用 API 
(invocation API) 使 你 能 够 把 Java 虚拟 机 嵌入 到 C 或 者 C++ 程序 中 。 下 面 是 你 初始 化 虚拟 机 
所 需 的 基本 代码 。 


JavaVMOption options[1]; 
JavaVMInitArgs vm_args; 
JavaVM *jvm; 
JNIEnv *env; 


options [0] .optionString = "-Djava.class.path=."; 


memset (&vm_args, 0, sizeof(vm_args)); 

vm_args.version = JNI_VERSION_1 2; 

vm_args.nOptions = 1; 

vm_args.options = options; 

JNI_CreateJavaVM(&jvm, (void**) &env, &vm_args) ; 

对 UNI_CreateJavavM 的 调用 将 创建 虚拟 机 ， 并 且 使 指针 jvm 指向 虚拟 机 ， 使 指针 
env 指 癌 执行 环境 。 

可 以 给 虚拟 机 提供 任意 数目 的 选项 ， 这 只 需 增 加 选项 数组 的 大 小 和 vm_args .nOptions 
的 值 。 例 如 ， 

options [i] .optionString = "-Djava.compiler=NONE"; 

可 以 钝 化 即时 编译 希 。 
@ 提示 : 当 你 陷入 麻烦 导致 程序 户 溃 ， 从 而 不 能 初始 化 JVM 或 者 不 能 装载 你 的 类 时 ， 请 打 

FT INI 调试 模式 。 设 置 一 个 选项 如 下 : 

options[i].optionString = "-verbose:jni"; 

你 会 看 到 一 系列 说 明 JVM 初始 化 进程 的 消息 。 如 果 看 不 到 你 装载 的 类 ， 请 检查 你 的 路 径 

和 类 路 径 的 设置 。 


一 日 设置 完 虚拟 机 ， 就 可 以 如 前 面 小 节 介绍 的 那样 调用 Java 方法 了 。 只 要 按 常 规 方法 使 
用 env 指针 即 可 。 

只 有 在 调用 invocation API 中 的 其 他 函数 时 ， 才 需要 jvm 指针 。 目 前 ， 只 有 四 个 这 样 的 
函数 。 最 重要 的 一 个 是 终止 虚拟 机 的 函数 : 

(*jvm)->DestroyJavaVM(j vm) ; 

遗憾 的 是 ， 在 Windows 下 ， 动 态 链接 到 jre/bin/client/jvm.d11 中 的 JINI_CreateJavaVM 
函数 变 得 非常 困难 ， 因 为 Vista 改变 了 链接 规则 ， 而 Oracle 的 类 库 仍 旧 依赖 于 旧版 本 的 C 运行 时 
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类 库 。 我 们 的 示例 程序 通过 手工 加 载 该 类 库 解决 了 这 个 问题 ， 这 种 方式 与 Java 程序 所 使 用 的 方 
式 一 样 ， 请 参阅 IDK 中 的 src. jar 文件 里 的 launcher/java_md.c 文件 。 

程序 清单 12-20 的 C 程序 设置 了 虚拟 机 ， 然 后 调用 了 Welcome 类 的 main 方法 ， 这 个 类 
在 卷 1 第 2 章 中 讨论 过 了 在 开始 启用 测试 程序 之 前 ， 务必 编 译 Welcome. java 文件 )。 





/** 
@version 1.20 2007-10-26 
@author Cay Horstmann 


*/ 


#include <jni.h> 
#include <stdlib.h> 


O oO ē N em tm 和 wu N | 


#ifdef _WINDOWS 


1 #include <windows.h> 
12 Static HINSTANCE load)VMLibrary(void) ; 
13 typedef jint (JNICALL *CreateJavaVM_t)(JavaVM **, void **, JavaVMInitArgs *); 


15 #endif 


17 Int main() 

18 { 

19 JavaVMOption options [2]; 
2  JavaWMInitArgs vm_args; 
21 JavaVM *jvm; 

22 JNIEnv *env; 

23 long status; 


25 Jclass class_Welcome; 
2 = jclass class String; 
27 JobjectArray args; 
28 jmethodID id_main; 


30 #ifdef _WINDOWS 

31 HINSTANCE hjvmlib; 

32 CreateJavaVM_t createJavaVM: 
3 #endif 


35 options [0] .optionString = "-Djava.class.path=."; 


37  memset(&vm_args, 0, sizeof(vm_args)); 
38 vm_args.version = JNI_VERSION 1 2; 

39 vm_args.nOptions = 1; 

40 vm_args.options = options; 


42 

43 #ifdef WINDOWS 

44 hjvmlib = loadJVMLibrary(); 

45 createJavaVM = (CreateJavaVM_t) GetProcAddress(hjvmlib, "JNI_CreateJavaVM"); 
46 Status = (*createJavaVM) (&jvm, (void **) &env, &vm_args); 
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47 #else 


status = JNI_CreateJavaVM(&jvm, (void **) &env, &vm_args); 


#endi f 


} 


if (status == JNI_ERR) 


fprintf(stderr, "Error creating VM\n"); 
return 1; 


} 


class Welcome = (*env)->FindClass(env, "Welcome”) ; 
id main = (*env)->GetStaticMethodID(env, class_Welcome, "main", "([Ljava/lang/String;)V") ; 


class String = (*env)->FindClass(env, "java/lang/String") ; 
args = (*env)->NewObjectArray(env, 0, class_String, NULL); 
(*env)->Cal1StaticVoidMethod(env, class Welcome, id_main, args); 


(*jvm)->DestroyJavaVM(jvm) ; 


return 0; 


#ifdef WINDOWS 


static int GetStringFromRegistry(HKEY key, const char *name, char *buf, jint bufsize) 


} 


DWORD type, size; 


return RegQueryValueEx(key, name, 0, &type, 0, &size) == 
&& type == REG_SZ 
&& size < (unsigned int) bufsize 
&& RegQueryValueEx(key, name, 0, 0, buf, &size) == 0; 


static void GetPublicJREHome(char *buf, jint bufsize) 


HKEY key, subkey; 
char version[MAX_PATH] ; 


/* Find the current version of the JRE */ 
char *JRE_KEY = "Software\\JavaSoft\\Java Runtime Environment”; 
if (RegOpenKeyEx(HKEY_LOCAL_MACHINE, JRE_KEY, 0, KEY_READ, &key) != 0) 


fprintf(stderr, "Error opening registry key ‘%s'\n", JRE_KEY) ; 
exit(1); 
} 


if (!GetStringFromRegistry(key, "CurrentVersion", version, sizeof(version))) 


fprintf(stderr, "Failed reading value of registry key:\n\t%s\\CurrentVersion\n", JRE_KEY); 
RegCloseKey (key) ; 
exit(1); 

} 
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101  /* Find directory where the current version is installed. */ 

102 if (RegOpenKeyEx(key, version, 0, KEY_READ, &subkey) != 0) 

13 { 

104 fprintf(stderr, "Error opening registry key '%s\\%s'\n", JRE_KEY, version); 
105 RegCloseKey (key) ; 

106 exit(1); 

107 } 

108 

109 if (!GetStringFromRegistry(subkey, "JavaHome", buf, bufsize)) 

110 

111 fprintf(stderr, "Failed reading value of registry key:\n\t%s\\%s\\JavaHome\n", 
112 JRE_KEY, version); 

113 RegCloseKey (key) ; 

114 RegCloseKey (subkey) ; 

115 exit(1); 

ue } 

117 

118 RegCloseKey (key); 

119 RegCloseKey(subkey) ; 

120 } 


121 
122 Static HINSTANCE loadJVMLibrary (void) 


123 { 

124  HINSTANCE h1, h2; 

125. char msvcdl] [MAX_PATH]; 

126 Char javadl 1 [MAX_PATH] ; 

127  GetPublicJREHome(msvcdl1, MAX_PATH) ; 

128 strcpy(javadll, msvcd11); 

129  strncat(msvcdll, "\\bin\\msvcr71.d11", MAX_PATH - strlen(msvcdl1)); 
130 msvcdl]l[MAX_PATH - 1] = '\0'; 

131  strncat(javadll, "\\bin\\client\\jvm.d11", MAX_PATH - strlen(javadl1)); 
132 Javadll[MAX_PATH - 1] = '\0'; 

133 

134 hl = LoadLibrary(msvcd11) ; 

35 if (hl == NULL) 

36 {d 

137 fprintf(stderr, "Can't load library msvcr71.d11\n"); 
138 exit(1); 

139 } 

140 

141 h2 = LoadLibrary(javadl1); 

142 if (h2 == NULL) 

143 





144 fprintf(stderr, "Can't load library jvm.dll\n"); 
145 exit(1); 

146 } 

147 return h2; 

148 } 

149 

150 #endif 


要 在 Linux 下 编译 该 程序 ， 请 用 : 


gcc -I jdk/include -I jdk/include/linux -o InvocationTest 
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-L jdk/jre/lib/i386/client -1jvm InvocationTest.c 
在 Solaris F, W: 


cc -I jdk/include -I jdk/include/solaris -o InvocationTest 
-L jdk/jre/lib/sparc -ljvm InvocationTest.c 


在 Windows 下 用 微软 的 C 编译 器 时 ， 请 用 下 面 的 命令 行 : 
cl -D WINDOWS -I jdk\include -I jdk\include\win32 InvocationTest.c jdk\lib\jvm.lib advapi32.1ib 


需要 确保 INCLUDE 和 LIB 环境 变量 包含 了 Windows API 头 文 件 和 库 文件 的 路 径 。 
用 Cygwin 时 ， 用 下 面 的 语句 进行 编译 : 


gcc -D_WINDOWS -mno-cygwin -I jdk\include -I jdk\include\win32 -D_int64="long long" 
-I c:\cygwin\usr\include\w32api -o InvocationTest 


在 Linux/UNIX 下 运行 该 程序 之 前 ， 需 要 确保 LD_LIBRARY_PATH 包含 了 共享 类 库 的 目 
录 。 例如， 如 果 使 用 Linux 上 的 bash 命令 行 ， 则 需要 执行 下 面 的 命令 : 


export LD_LIBRARY_PATH=jdk/jre/1ib/i386/client:$LD_LIBRARY_PATH 





® jint JNI_CreateJavaVM(JavaVM** p_jvm, void** p_env, JavaVMInitArgs* 
vm_args) 
初始 化 Java 虚拟 机 。 如 果 成 功 ， 则 返回 0， 否则 返回 JNI_ERR。 
参数 : p_jvm  ” 填 人 指向 调用 API 函数 表 的 指针 
p_env 填 和 人 指向 INI 函数 表 的 指针 
vm_args 虚拟 机 参数 
è jint DestroyJavaVM(JavaVM* jvm) 
销毁 虚拟 机 。 如 果 成 功 ， 则 返回 0， 和 否则 返回 一 个 负 值 。 该 函数 必须 通过 一 个 虚拟 机 
指针 调用 。 例 如 ，(*jvm)->DestroyUavaVvM(jvm)。 


12.10 ”完整 的 示例 : 访问 Windows 注册 表 


在 本 节 中 ， 我 们 介绍 一 个 完整 的 可 运行 的 例子 ， 涵 盖 了 我 们 在 本 章 讨论 的 所 有 内 容 : 使 
用 带 有 字符 串 、 数 组 和 对 象 的 本 地 方法 ， 构 造 器 调用 和 错误 处 理 。 我 们 将 展示 如 何 用 Java 
平台 包装 器 来 包装 普通 的 基于 C 的 API 子 集 ， 用 于 进行 Windows 注册 表 操 作 。 当 然 ， 由 于 
Windows 的 具体 特性 ， 使 用 Windows 注册 表 的 程序 天 生 就 不 可 移植 。 基 于 这 个 原因 ， 标 准 的 
Java 库 不 支持 注册 表 ， 所 以 使 用 本 地 方法 访问 注册 表 是 有 意义 的 。 


12.10.1 Windows 注册 表 概 述 


Windows 注册 表 是 一 个 存放 Windows 操作 系统 和 应 用 程序 的 配置 信息 的 数据 仓库 。 它 
提供 了 对 系统 和 应 用 程序 参数 的 单 点 管理 和 备份 。 其 不 足 的 方面 是 ， 注 册 表 的 错误 也 是 单 点 
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的 。 如 果 你 弄 乱 了 注册 表 ， 你 的 电脑 就 会 出 故障 ， 甚 至 无 法 启动 。 

我 们 不 建议 你 使 用 注册 表 来 存储 Java 程序 的 配置 参数 。Java 配置 API ( preferences API) 
是 一 个 更 好 的 解决 方案 (更 多 信息 请 参见 卷 1 第 13 章 )。 我 们 使 用 注册 表 只 是 为 了 说 明 怎 样 
把 重要 的 本 地 API 包装 成 Java 类 。 

检查 注册 表 的 主要 工具 是 注册 表 编 辑 器 。 由 于 可 能 存在 幼稚 而 狂热 的 用 户 ， 所 以 
Windows 没有 配备 任何 图 标 来 启动 注册 表 编 辑 器 。 你 必须 启动 DOS shell (或 打开 “ 开 
始 ” 一 “运行 ”对 话 框 ) AAA regedit, B 12-4 给 出 了 一 个 运行 中 的 注册 表 编 辑 器 。 
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左边 是 树 形 结构 排列 的 注册 表 键 。 请 注意 ， 每 个 键 部 以 HKEY 市 点 开始 ， 如 : 


HKEY_CLASSES_ROOT 
HKEY_CURRENT_USER 
HKEY_LOCAL_MACHINE 


右边 是 与 特定 键 关 联 的 名 / 值 对 。 例 如 ， 如 果 你 安装 了 Java SE 7， 那 么 键 : 
HKEY_LOCAL_MACHINE\Software\JavaSoft\Java Runtime Environment 

就 包含 下 面 这 样 的 名 值 对 : 
CurrentVersion="1.7.0_10" 


在 本 例 中 ， 值 是 字符 串 。 值 也 可 以 是 整数 或 字 节 数组 。 
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12.10.2 访问 注册 表 的 Java 平台 接口 


我 们 创建 了 一 个 从 Java 代码 访问 注册 表 的 简单 接口 ， 然 后 用 本 地 代码 实现 了 这 个 接口 。 
我 们 的 接口 只 允许 几 个 注册 表 操 作 ， 为 了 保持 较 小 的 代码 规模 ， 我 们 省 略 了 其 他 重要 的 操 
作 ， 如 : 添加 、 删 除 和 枚 举 注册 表 键 (添加 剩余 的 这 些 注册 表 API PRE IRA SD ) o 

即使 使 用 我 们 提供 的 受 限 的 子 集 ， 你 也 可 以 : 

e 枚 举 某 个 键 中 存储 的 所 有 名 字 。 

o 读 出 用 某 个 名 字 存 储 的 值 。 

e 设置 用 某 个 名 字 存 储 的 值 。 

下 面 是 封装 注册 表 键 的 Java 类 : 

class Win32RegKey 


} 


public Win32RegKey(int theRoot, String thePath) {. .. } 
public Enumeration names) {... } 

public native Object getValue(String name) ; 

public native void setValue(String name, Object value); 


public static final int HKEY_CLASSES ROOT = 0x80000000; 
public static final int HKEY_CURRENT_USER = 0x80000001; 
public static final int HKEY_LOCAL_MACHINE = 0x80000002; 


names 方法 返回 与 该 键 存 放 在 一 起 的 所 有 名 字 的 一 个 枚 举 ， 你 可 以 用 你 熟悉 的 
hasMoreElements/nextElement 方法 获取 它们 。getValue 方法 返回 一 个 对 象 ， 该 对 象 可 
以 是 字符 串 、Integer 对 象 或 字 节 数 组 。setValue 方法 的 value 参数 也 必须 是 上 述 三 种 类 
型 之 一 。 


12.10.3 ”以 本 地 方法 方式 实现 注册 表 访问 函数 


我 们 需要 实现 三 个 操作 : 

o 获取 某 个 键 的 值 。 

e 设置 某 个 键 的 值 。 

o ABN AS. 

幸运 的 是 ， 你 基本 上 已 经 看 到 了 所 有 必须 的 工具 ， 如 Java 字符 串 和 数组 到 C 的 字符 串 和 
数组 的 转换 ， 还 了 解 了 如 何在 出 错时 抛 出 异常 。 

有 两 个 问题 使 得 这 些 本 地 方法 比 之 前 的 例子 更 加 复杂 。getValue 和 setValue 方法 处 
理 的 是 Object 类 型 ， 它 可 以 是 String、Integer 或 byte[ ] 之 一 。 枚 举 对 象 需要 用 来 存 
放 连 续 的 对 hasMoreElements 和 nextElement 的 调用 之 间 的 状态 。 

让 我 们 先 看 一 下 getValue 方法 ， 该 方法 (程序 清单 12-22 Pras) 经 历 了 以 下 几 个 步骤 : 


1) 打开 注册 表 键 。 为 了 读 取 它们 的 值 ， 注 册 表 API 要 求 这 些 键 是 开放 的 。 


2) 查询 与 名 字 关 联 的 值 的 类 型 和 大 小 。 
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3) 把 数据 读 到 缓存 。 

4) 如 果 类 型 是 REG_Sz( 字 符 串 )， 调 用 NewStringUTF ， 用 该 值 来 创建 一 个 新 的 字符 串 。 

5 ) 如 果 类 型 是 REG_DWORD (32 位 整数 )， 调 用 Integer 构造 髓 。 

6) 如 果 类 型 是 REG_BINARY， 调 用 NewByteArray 来 创建 一 个 新 的 字 节 数组 ， 并 调用 
SetByteArrayRegion， 把 值 数据 复制 到 该 字 节 数组 中 。 

7) 如 果 不 是 以 上 类 型 或 调用 API 函数 时 出 现 错误 ， 那 就 抛 出 异常 ， 并 小 心地 释放 到 此 
为 止 所 获得 的 所 有 资源 。 

8) 关闭 键 ， 并 返回 创建 的 对 象 (String, Integer 或 byte[])。 

如 你 所 见 ， 这 个 例子 很 好 地 说 明了 怎样 产生 不 同类 型 的 Java 对 象 。 

在 本 地 方法 中 ， 处 理 泛 化 的 返回 类 型 并 不 困难 ，jstring、jobject 或 jarray 引用 都 
可 以 直接 作为 一 个 jobject 人 返回。 但是，setValue 方法 接受 的 是 一 个 对 Object 的 引用 ， 
FFA, 为 了 把 该 0bject 保存 为 字符 串 、 整 数 或 字 节 数组 ， 必 须 确定 该 0bject 的 确切 类 型 。 
我 们 可 以 通过 查询 value 对 象 的 类 ， 找 出 对 java.lang.String, java.lang. Integer 和 
byte[] 的 引用 ,将 其 与 1sAssignableFrom 困 数 进行 比较 ， 从 而 确定 它 的 确切 类 型 。 

WR classl 和 class2 是 两 个 类 引用 ， 那 么 调用 : 


(*env)->IsAssignableFrom(env, class1, class2) 


“4 classl 和 class2 是 同一 个 类 或 classl 是 class2 的 子 类 时 ， 返 回 UNI_TRUE, 在 
这 两 种 情况 下 ，c1assl 对 象 的 引用 都 可 以 转型 到 class2。 例 如 ， 当 : 

(*env)->IsAssignableFrom(env, (*env)->GetObjectClass(env, value), (*env)->FindClass(env, "[B")) 

A true 时 ， 那 么 我 们 就 知道 该 值 是 一 个 字 市 数组 。 

下 面 是 对 setValue 方法 中 的 步骤 的 概述 : 

1) 打开 注册 表 键 以 便 写 人 。 

2) 找 出 要 写 人 的 值 的 类 型 。 

3 ) 如 果 类 型 是 string， 调用 GetStringUTFChars 获取 一 个 指向 这 些 字 符 的 指针 。 

4) 如 果 类 型 是 Integer ， 调 用 intValue 方法 获取 该 包装 器 对 象 中 存储 的 整数 。 

5) 如 果 类 型 是 byte[]， 调 用 GetByteArrayElements 获取 指 癌 这 些 字 市 的 指针 。 

6 ) 把 数据 和 长 度 传递 给 注册 表 。 

7) 关闭 键 。 

8) 如 果 类 型 是 String 或 byte[]， 那 么 还 要 释放 指向 数据 的 指针 。 

最 后 ,我 们 介绍 枚 举 键 的 本 地 方法 。 这 些 方法 属于 Win32RegKeyNameEnumeration 类 
(参见 程序 清单 12-21 )。 当 枚 举 过 程 开 始 时 ， 我 们 必须 打开 键 。 在 枚 举 过 程 中 ， 我 们 必须 保 
持 该 键 的 句柄 。 也 就 是 说 ,该 键 的 句柄 必须 与 枚 举 对 象 存 放 在 一 起 。 键 的 句柄 是 DWORD 类 型 
的 ， 它 是 一 个 32 位 数 ， 所 以 可 以 存放 在 一 个 Java 的 整数 中 。 它 被 存放 在 枚 举 类 的 hkey 域 
中 ， 当 枚 举 开始 时 , SetIntField 初始 化 该 域 ， 而 后 续 的 调用 用 GetIntFie1ld 来 读 取 其 值 。 

在 这 个 例子 里 ， 我 们 用 枚 举 对 象 存 放 了 另外 三 个 数据 项 。 当 枚 举 一 开始 ， 我 们 可 以 从 注 





#12% 大 她 方法 793 


册 表 中 查询 到 名 / 值 对 的 个 数 和 最 长 名 字 的 长 度 ， 我 们 需要 这 些 信息 ， 因 此 我 们 分 配 C 字符 
数组 以 保存 这 些 名 字 。 这 些 值 存放 在 枚 举 对 象 的 count 和 maxsize 域 中 。 最 后 ，index 域 
被 初始 化 为 -1， 表 示 枚 举 的 开始 。 一 旦 其 他 实例 域 被 初始 化 ，index 域 就 被 置 为 0， 在 完成 
每 个 枚 举 步 骤 之 后 ， 都 会 进行 递增 。 

让 我 们 简要 介绍 一 下 支持 枚 举 的 本 地 方法 。hasMoreElements 方法 很 简单 : 

1 ) 获取 index All count 域 。 

2) 如 果 index Æ- 1, JJH startNameEnumeration KATHE, 查询 数量 和 最 大 长 
度 ， 初 始 化 hkey、count 、maxsize Ail index 域 。 

3) 如 果 index 小 于 count, ， 则 返回 UNI_TRUE， 否 则 返回 UNI_FALSE, 

nextE lement 方法 要 复杂 一 些 。 

1) 获取 index 和 count 域 。 

2) 如 果 index Æ- 1， 调 用 startNameEnumeration KAGIT ITE, 查询 数量 和 最 大 长 
RE, 初始 化 hkey、count maxsize Ñi index 域 。 

3) 如 果 index 等 于 count， 抛 出 一 个 NoSuchE1ementException 异常 。 

4) 从 注册 表 中 读 人 下 一 个 名 字 。 

5 ) 递增 index, 

6) 如 果 index 等 于 count, ， 则 关闭 键 。 

在 编译 之 前 ， 记 得 在 Win32RegKey 和 Win32RegKeyNameEnumeration 上 都 要 运行 
javah。 微 软 编译 器 的 完整 命令 行 如 下 : 

cl -I jdk\include -I jdk\include\win32 -LD Win32Regkey.c advapi32.1ib -FeWin32RegKey.d11 

Cygwin 系统 上 ， 请 使 用 : 


gcc -mno-cygwin -D _int64="]ong long" -I jdk\include -I jdk\include\win32 
-I c:\cygwin\usr\include\w32api -shared -W1,--add-stdcall-alias -o Win32RegKey.d11 
Win32RegKey.c 


因为 注册 表 API 是 针对 Windows 的 ， 所 以 这 个 程序 不 能 在 其 他 操作 系统 上 运行 。 

程序 清单 12-23 给 出 了 测试 我 们 新 的 注册 表 函 数 的 程序 。 我 们 在 键 中 添加 了 三 个 名 值 对 : 
一 个 字符 串 、 一 个 整数 和 一 个 字 市 数组 。 

HKEY_CURRENT_USER\Software\JavaSoft\Java Runtime Environment 

然后 ， 我 们 枚 举 该 键 的 所 有 名 字 并 获取 它们 的 值 。 该 程序 应 该 打印 如 下 信息 : 


Default user=Harry Hacker 
Lucky number=13 
Smal] primes=2 3 5 7 11 13 


虽然 在 该 键 中 添加 这 些 名 值 对 不 会 有 什么 危害 ， 但 是 在 运行 该 程序 后 ， 你 可 能 还 是 想 使 
用 注册 表 编 辑 器 去 移 除 它们 。 





1 import java.util.*; 
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/** 
* A Win32RegKey object can be used to get and set values of a registry key in the Windows 
* registry. 
* @version 1.00 1997-07-01 
* @author Cay Horstmann 
* 
/ 
public class Win32RegKey 
{ 
public static final int HKEY_CLASSES ROOT = 0x80000000; 
public static final int HKEY_CURRENT_USER = 0x80000001; 
public static final int HKEY_LOCAL_MACHINE = 0x80000002; 
public static final int HKEY_USERS = 0x80000003; 
public static final int HKEY_CURRENT_CONFIG = 0x80000005; 
public static final int HKEY_DYN DATA = 0x80000006; 


private int root; 
private String path; 


/** 
* Gets the value of a registry entry. 
* @param name the entry name 
* @return the associated value 
"y 
public native Object getValue(String name); 


kk 


* Sets the value of a registry entry. 
* @param name the entry name 

* @param value the new value 

pi 


public native void setValue(String name, Object value); 


/** 
* Construct a registry key object. 
* @param theRoot one of HKEY_CLASSES_ROOT, HKEY_CURRENT_USER, HKEY_LOCAL_MACHINE, HKEY_USERS, 
* HKEY_CURRENT_CONFIG, HKEY_DYN_DATA 
* @param thePath the registry key path 
| 
public Win32RegKey(int theRoot, String thePath) 
{ 
root = theRoot; 
path = thePath; 


} 
/** 


* Enumerates all names of registry entries under the path that this object describes. 
* @return an enumeration listing all entry names 

*/ 

public Enumeration<String> names () 


{ 
} 


return new Win32RegKeyNameEnumeration(root, path); 


static 
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System. loadLibrary("Win32Regkey") ; 
} 
} 


class Win32RegKeyNameEnumeration implements Enumeration<String> 
{ 

public native String nextE]ement () ; 

public native boolean hasMoreElements () ; 

private int root; 

private String path; 

private int index = -1; 

private int hkey = 0; 

private int maxsize; 

private int count; 


Win32RegkeyNameEnumeration(int theRoot, String thePath) 


root = theRoot; 
path = thePath; 
} 
} 


class Win32RegKeyException extends RuntimeException 


public Win32RegKeyException () 
{ 
} 


public Win32RegKeyException(String why) 


super (why) ; 


ak 


@version 1.00 1997-07-01 
@author Cay Horstmann 


" 


#include "Win32RegKey.h" 

#include "Win32RegkeyNameEnumeration.h" 
#include <string.h> 

#include <stdlib.h> 

#include <windows ,h> 


JNIEXPORT jobject JNICALL Java_Win32RegKey_getValue(JNIEnv* env, jobject this_obj, jobject name) 
{ 


const char* cname; 
jstring path; 
const char* cpath; 
HKEY hkey; 
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DWORD type; 

DWORD size; 

jclass this_class; 
jfieldID id_root; 
jfieldID id_path; 
HKEY root; 

jobject ret; 

char* cret; 


/* get the class */ 
this_class = (*env)->GetObjectClass(env, this_obj); 


/* get the field IDs */ 
id_root = (*env)->GetFieldID(env, this_class, "root", "1"); 
id_path = (*env)->GetFieldID(env, this_class, "path", "Ljava/lang/String;"); 


/* get the fields */ 

root = (HKEY) (*env)->GetIntField(env, this_obj, id_root); 

path = (jstring) (*env)->GetObjectField(env, this_obj, id_path); 
cpath = (*env)->GetStringUTFChars(env, path, NULL); 


/* open the registry key */ 
if (RegOpenKeyEx(root, cpath, 0, KEY_READ, &hkey) != ERROR SUCCESS) 
{ 


(*env)->ThrowNew(env, (*env)->FindClass(env, "Win32RegKeyException"), 
"Open key failed"); 
(*env)->ReleaseStringUTFChars(env, path, cpath); 
return NULL; 
} 


(*env)->ReleaseStringUTFChars(env, path, cpath); 
cname = (*env)->GetStringUTFChars(env, name, NULL); 


/* find the type and size of the value */ 
if (RegQueryValueEx(hkey, cname, NULL, &type, NULL, &size) != ERROR_SUCCESS) 
{ 


(*env)->ThrowNew(env, (*env)->FindClass(env, "Win32RegKeyException") ， 
"Query value key failed"); 
RegCloseKey (hkey) ; 
(*env)->ReleaseStringUTFChars(env, name, cname); 
return NULL; 
} 


/* get memory to hold the value */ 
cret = (char*)malloc(size); 


/* read the value */ 
if (RegQueryValueEx(hkey, cname, NULL, &type, cret, &size) != ERROR SUCCESS) 
{ 


(*env)->ThrowNew(env, (*env)->FindClass(env, "Win32RegKeyException") , 
"Query value key failed"); 

free(cret); 

RegCloseKey (hkey) ; 

(*env)->ReleaseStringUTFChars(env, name, cname); 
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return NULL; 
} 


/* depending on the type, store the value in a string, 
integer or byte array */ 
if (type == REG_SZ) 


ret = (*env)->NewStringUTF(env, cret); 


} 
else if (type == REG_DWORD) 
{ 
jclass class_Integer = (*env)->FindClass(env, "java/lang/Integer’) ; 
/* get the method ID of the constructor */ 
jmethodID id_Integer = (*env)->GetMethodID(env, class_Integer, "<init>’, DPR 
int value = *(int*) cret; 
/* invoke the constructor */ 
ret = (*env)->NewObject(env, class_Integer, id_Integer, value); 


} 
else if (type == REG_BINARY) 
{ 


ret = (*env)->NewByteArray(env, size); 
(*env)->SetByteArrayRegion(env, (jarray) ret, 0, size, cret); 
} 


else 


(*env)->ThrowNew(env, (*env)->FindClass (env, "Win32RegKeyException"), 
"Unsupported value type"); 
ret = NULL; 
} 
free(cret); 
RegCloseKey (hkey) ; 
(*env)->ReleaseStringUTFChars(env, name, cname) ; 


return ret; 


109 JNIEXPORT void JNICALL Java Win32RegKey_setValue(JNIEnv* env, jobject this obj, 


110 
in { 
112 
113 
114 
115 
116 
117 
118 
119 
120 
121 
122 
123 
124 
125 


jstring name, jobject value) 


const char* cname; 
jstring path; 

const char* cpath; 
HKEY hkey; 

DWORD type; 

DWORD size; 

jclass this_class; 
jclass class_value; 
jclass class_Integer; 
jfieldID id_root; 
jfieldID id_path; 
HKEY root; 

const char* cvalue; 
int ivalue; 
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/* get the class */ 
this_class = (*env)->GetObjectClass(env, this_obj); 


/* get the field IDs */ 
id_root = (*env)->GetFieldID(env, this_class, "root", "I"); 
id_path = (*env)->GetFieldID(env, this_class, "path", "Ljava/lang/String;"); 


/* get the fields */ 

root = (HKEY) (*env)->GetIntField(env, this_obj, id_root); 

path = (jstring) (*env)->GetObjectField(env, this_obj, id_path); 
cpath = (*env)->GetStringUTFChars(env, path, NULL); 


/* open the registry key */ 
if (RegOpenKeyEx(root, cpath, 0, KEY_WRITE, &hkey) != ERROR SUCCESS) 
{ 


(*env)->ThrowNew(env, (*env)->FindClass(env, "Win32RegKeyException") , 
"Open key failed"); 

(*env)->ReleaseStringUTFChars(env, path, cpath); 

return; 


} 


(*env)->ReleaseStringUTFChars(env, path, cpath); 
Cname = (*env)->GetStringUTFChars(env, name, NULL); 


class_value = (*env)->GetObjectClass(env, value): 

class_Integer = (*env)->FindClass(env, "java/lang/Integer"); 

/* determine the type of the value object */ 

if ((*env)->IsAssignableFrom(env, class_value, (*env)->FindClass(env, "java/lang/String"))) 


/* it is a String--get a pointer to the characters */ 

cvalue = (*env)->GetStringUTFChars(env, (jstring) value, NULL); 
type = REG_SZ; 

size = (*env)->GetStringLength(env, (jstring) value) + 1; 


else if ((*env)->IsAssignableFrom(env, class_value, class_Integer)) 


/* it is an integer--call intValue to get the value */ 

jmethodID id_intValue = (*env)->GetMethodID(env, class Integer, "intValue", "()I"): 
ivalue = (*env)->CallIntMethod(env, value, id_intValue); 

type = REG_DWORD; 

cvalue = (char*)&ivalue; 

size = 4; 


else if ((*env)->IsAssignableFrom(env, class_value, (*env)->FindClass(env, "[B"))) 


/* it is a byte array--get a pointer to the bytes */ 
type = REG BINARY; 
cvalue = (char*) (*env)->GetByteArrayElements(env, (jarray) value, NULL): 
size = (*env)->GetArrayLength(env, (jarray) value); 
} 


else 


/* we don't know how to handle this type */ 
(*env)->ThrowNew(env, (*env)->FindClass(env, "Win32RegKeyException"), 
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181 "Unsupported value type"); 

182 RegCloseKey (hkey) ; 

183 (*env)->ReleaseStringUTFChars(env, name, cname) ; 
184 return; 

15 } 


187  /* set the value */ 
188 if (RegSetValueEx(hkey, cname, 0, type, cvalue, size) != ERROR_SUCCESS) 


190 (*env)->ThrowNew(env, (*env)->FindClass (env, "Win32RegKeyException") , 
191 "Set value failed"); 
i2 } 


194 RegCloseKey(hkey) ; 
195  (*env)->ReleaseStringUTFChars(env, name, cname) ; 


137  /* if the value was a string or byte array, release the pointer */ 
198 if (type == REG_SZ) 
{ 


200 (*env)->ReleaseStringUTFChars(env, (jstring) value, cvalue) ; 


201 } 
22 else if (type == REG_BINARY) 
{ 


204 (*env)->ReleaseByteArrayElements(env, (jarray) value, (jbyte*) cvalue, 0); 
205 } 

206 } 

207 

208 /* helper function to start enumeration of names: */ 

209 Static int startNameEnumeration(JNIEnv* env, jobject this_obj, jclass this_class) 
210 { 

211  jfieldID id_index; 

22  jfieldID id_count; 

213  jfieldID id_root; 

214  jfieldID id_path; 

215  jfieldID id_hkey; 

216  jfieldID id_maxsize; 

217 

218 HKEY root; 

219 jstring path; 

20 const char* cpath; 

221 HKEY hkey; 

222 DWORD maxsize = 0; 

223 DWORD count = 0; 

224 

2s  /* get the field IDs */ 

26  id_root = (*env)->GetFieldID(env, this_class, "root", "I"); 

27  id_path = (*env)->GetFieldID(env, this_class, "path", "Ljava/lang/String;"); 
2s  id_hkey = (*env)->GetFieldID(env, this_class, "hkey", "I"); 

29 id maxsize = (*env)->GetFieldID(env, this_class, “maxsize", "I"); 
230 id_index = (*env)->GetFieldID(env, this_class, "index", "I"); 

B31 id_count = (*env)->GetFieldID(env, this_class, "count", "I"); 

232 

233  /* get the field values */ 

234 root = (HKEY)(*env)->GetIntField(env, this_obj, id_root); 
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235 
236 
237 
238 
239 
240 
241 
242 
243 
244 
245 
246 
247 
248 
249 
250 
251 
252 
253 
254 
255 
256 
257 
258 
259 
260 
261 
262 
263 
264 } 
265 


266 JNIEXPORT jboolean JNICALL Java_Win32RegKeyNameEnumeration_hasMoreElements(JNIEnv* env, 


267 
268 { 
269 
270 
271 
272 
273 
274 
275 
276 
277 
278 
279 
280 
281 
282 
283 
284 
285 
286 
287 
288 


path = (jstring) (*env)->GetObjectField(env, this_obj, id_path); 
cpath = (*env)->GetStringUTFChars(env, path, NULL); 


/* open the registry key */ 
if (RegOpenkeyEx(root, cpath, 0, KEY_READ, &hkey) != ERROR SUCCESS) 
{ 


(*env)->ThrowNew(env, (*env)->FindClass(env, "Win32RegKeyException"), 
"Open key failed"); 

(*env)->ReleaseStringUTFChars(env, path, cpath); 

return -1; 


(*env)->ReleaseStringUTFChars(env, path, cpath); 


/* query count and max length of names */ 
if (RegQueryInfoKey(hkey, NULL, NULL, NULL, NULL, NULL, NULL, &count, &maxsize, 
NULL, NULL, NULL) != ERROR_SUCCESS) 


(*env)->ThrowNew(env, (*env)->FindClass(env, "Win32RegKeyException"), 
"Query info key failed"); 

RegCloseKey (hkey) ; 

return -1; 


} 


/* set the field values */ 

(*env)->SetIntField(env, this_obj, id_hkey, (DWORD) hkey); 
(*env)->SetIntField(env, this_obj, id_maxsize, maxsize + 1); 
(*env)->SetIntField(env, this_obj, id_index, 0); 
(*env)->SetIntField(env, this_obj, id_count, count); 

return count; 


jobject this_obj) 

jclass this_class; 

jfieldID id_index; 

jfieldID id_count; 

int index; 

int count; 

/* get the class */ 

this_class = (*env)->GetObjectClass(env, this_obj); 


/* get the field IDs */ 
id_index = (*env)->GetFieldID(env, this_class, "index", "1"); 
id_count = (*env)->GetFieldID(env, this_class, "count", "I"); 


index = (*env)->GetIntField(env, this_obj, id_index); 
if (index == -1) /* first time */ 
{ 


count = startNameEnumeration(env, this_obj, this_class); 
index = 0; 
} 
else 
count = (*env)->GetIntField(env, this_obj, id_count); 
return index < count; 
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289 } 

290 

291 JNIEXPORT jobject JNICALL Java_Win32RegKeyNameEnumeration_nextE]ement (JNIEnv* env, 
292 jobject this_obj) 

293 { 

234 jclass this_class; 

295 jfieldID id_index; 

296  jfieldID id_hkey; 

297  jfieldID id_count; 

298 jfieldID id_maxsize; 

299 

300 HKEY hkey; 

31 int index; 

302 int count; 

303 DWORD maxsize; 

304 

305  char* cret; 

306  jstring ret; 

307 

308  /* get the class */ 

309  this_class = (*env)->GetObjectClass(env, this_obj); 

310 

31  /* get the field IDs */ 

32 id_index = (*env)->GetFieldID(env, this_class, "index", "I"); 
33 id count = (*env)->GetFieldID(env, this_class, "count", "I"); 
314 id_hkey = (*env)->GetFieldID(env, this_class, "hkey", "I"); 
315  id_maxsize = (*env)->GetFieldID(env, this_class, "maxsize", "I"); 
316 

37 index = (*env)->GetIntField(env, this_obj, id_index); 

38 if (index == -1) /* first time */ 


39 { 

320 count = startNameEnumeration(env, this_obj, this_class) ; 
321 index = 0; 

322 } 

323 else 

324 count = (*env)->GetIntField(env, this_obj, id_count); 


325 
326 if (index >= count) /* already at end */ 
327 


328 (*env)->ThrowNew(env, (*env)->FindClass(env, "java/util/NoSuchE]ementException’), 
329 "past end of enumeration”) ; 

330 return NULL; 

31 } 


332 
33  maxsize = (*env)->GetIntField(env, this_obj, id_maxsize); 
334 hkey = (HKEY) (*env)->GetIntField(env, this_obj, id_hkey); 
35 cret = (char*)malloc(maxsize) ; 


37  /* find the next name */ 
338 if (RegEnumValue(hkey, index, cret, &maxsize, NULL, NULL, NULL, NULL) != ERROR_SUCCESS) 


340 (*env)->ThrowNew(env, (*env)->FindClass(env, "Win32RegKeyException’), 
341 "Enum value failed"); 
342 free(cret); 


343 RegCloseKey (hkey) ; 
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2 
3 
4 
5 
6 
7 
8 
9 


(*env)->SetIntField(env, this_obj, id_index, count); 
return NULL; 


} 


ret = (*env)->NewStringUTF(env, cret): 
free(cret); 


/* increment index */ 
index++; 
(*env)->SetIntField(env, this_obj, id_index, index); 


if (index == count) /* at end */ 


RegCloseKey (hkey) ; 


return ret; 





import java.util.*; 


/** 


@version 1.02 2007-10-26 
@author Cay Horstmann 


* 


public class Win32RegkeyTest 


{ 


public static void main(String[] args) 


Win32RegKey key = new Win32RegKey( 


Win32RegKey.HKEY_CURRENT_USER, "Software\\JavaSoft\\Java Runtime Environment") ; 


key.setValue("Default user", "Harry Hacker"); 
key.setValue("Lucky number", new Integer(13)); 
key.setValue("Smal] primes", new byte[] { 2, 3, 5, 7, 11 }); 


Enumeration<String> e = key.names(); 


while (e.hasMoreElements()) 


{ 


String name = e.nextElement(); 
System.out.print(name + "="); 


Object value = key.getValue(name) ; 
if (value instanceof byte[]) 

for (byte b : (byte[]) value) System.out.print((b & OxFF) +" "); 
else 

System. out. print (value) ; 


System.out.printin(); 
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e jboolean IsAssignableFrom(JNIEnv *env, jclass cll, jclass c12) 
如 果 第 一 个 类 的 对 象 可 以 赋 给 第 二 个 类 的 对 象 ， 则 返回 JNI_TRUE， 否 则 返回 JNI_ 


FALSE。 这 个 函数 可 以 测试 : 两 个 类 是 否 相 同 ，c11 是 否 是 c12 的 子 类 ，c12 是 否 表 
示 一 个 由 c11 或 它 的 一 个 超 类 实现 的 接口 。 


èe jclass GetSuperclass(JNIEnv *env, jclass cl) 


返回 某 个 类 的 超 类 。 如 果 c1 表示 Object 类 或 一 个 接口 ， 则 返回 NULL。 


一 路 走 来 ， 大 家 已 经 学 习 了 许多 高 级 API， 现 在 ， 终 于 结束 了 。 我 们 从 每 位 Java 程序 员 
都 应 该 了 解 的 主题 开始 ， 即 : 流 、XML、 网 络 、 数 据 库 和 国际 化 ， 又 用 了 篇 幅 很 长 的 三 章 阐 
述 了 图 形 和 GUI 编程 ， 最 后 用 非常 技术 性 的 几 章 结尾 ， 即 安全 、 注 解 处 理 和 本 地 方法 。 我 们 
布 望 你 能 够 真正 享受 这 个 旅程 ， 掌 握 这 些 涉及 领域 广泛 的 Java API， 并 能 够 将 这 些 新 知识 应 
用 到 你 的 项 目 中 。 
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高 级 特性 ( 原 书 第 10 版 ) 


一 直 以 来 ，《Java 核 心 技术 》 都 被 认为 是 面向 高 级 程序 员 的 经 典 教 程 和 参考 书 ， 它 内 容 翔实 、 客 观 准确 ， 不 
拖泥带水 ， 是 想 为 实际 应 用 编写 健壮 java 代码 的 程序 员 的 首选 。 如 今 ， 本 版 进行 了 全 面 更 新 ， 以 反映 近年 来 人 
们 瘾 首 以 待 、 变 革 最 大 的 Java 版 本 (Java SE 8 ) 的 内 容 。 这 一 版 经 过 重 写 ， 并 重新 组 织 ， 全 面 曾 释 了 新 的 Java 
SE 8 特性 、 惯 用 法 和 最 佳 实践 ， 其 中 包含 数 百 个 示例 程序 ， 所 有 这 些 代 码 都 经 过 精心 设计 ， 不 仅 易 于 理解 ， 也 很 
容易 实际 应 用 。 

本 书 为 专业 程序 员 解 决 实际 问题 而 写 ， 可 以 帮助 你 深入 了 解 Java 语 言 和 库 。 在 卷 IH 中 ，Horstmann 主 要 提供 
了 对 多 个 高 级 主题 的 深度 讨论 ， 包 括 新 的 流 API、 日 期 /时 间 / 日 历 库 、 高 级 Swing、 安 全 、 代 码 处 理 等 主题 。 


通过 阅读 本 书 ， 你 将 : 
@ 使 用 新 的 流 库 来 更 灵活 高 效 地 处 理 集合 
o 高 效 地 访问 文件 和 目录 ， 读 / 写 二 进 制 或 文本 数据 ， 以 及 序列 化 对 象 
@ 使 用 Java SE 8 的 正则 表达 式 包 
在 Java 中 操作 XML : 解析 、 校 验 、XPath、 文 档 生 成 、XSL 等 
高 效 地 将 Java 程 序 连接 到 网 络 服务 
用 JDBC 4.2 编 程 
用 新 的 java.time API 优 雅 地 克服 日 期 /时 间 编 程 的 复杂 
用 本 地 化 的 日 期 /时 间 、 数 字 、 文 本 和 GUL 来 编写 国际 化 的 程序 
用 脚本 API、 编 译 器 API 和 注解 处 理 器 来 处 理 代码 
通过 类 加 载 器 、 字 节 码 校 验 、 安 全 管理 器 、 权 限 、 用 户 认 证 、 数 字 签名 、 代 码 签 名 和 加 密 来 增强 安全 
掌握 列表 、 表 、 树 、 文 本 和 进度 指示 器 等 高 级 Swing 构 件 
用 Java 2D API 产 生 高 质量 的 绘图 
o 使 用 JNI 本 地 方法 来 利用 其 他 语言 编写 的 代码 


如 果 你 是 一 个 资深 程序 员 ， 刚 刚 转向 Java SE 8， 本 书 绝对 是 可 靠 、 实 用 的 “伙伴 ”， 不 仅 现在 能 帮助 你 ， 
在 未 来 的 很 多 年 还 会 继续 陪伴 你 前 行 。 

查看 《Java 核 心 技术 41 基础 知识 ( 原 书 第 10 版 ) 》， 可 以 了 解 包括 Java 8 语言 概念 、UI 编 程 、 对 象 、 泛 
型 、 集 合 、lambda 表 达 式 、 并 发 、 函 数 式 编程 等 在 内 的 基础 知识 。 
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